@stll/folio-core 0.62.0 → 0.63.0

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

@@ -1,8 +1,8 @@
 import { document_d_exports } from "../../types/document.js";
 //#region src/docx/server/createBilingualDocument.d.ts
-type BilingualRowKind = "paragraph" | "heading" | "listItem";
+export type BilingualRowKind = "paragraph" | "heading" | "listItem";
 /** One translatable unit: a source paragraph and its right-column copy. */
-type BilingualParagraphRef = {
+export type BilingualParagraphRef = {
   /** `paraId` of the untouched source paragraph (left column). */
   sourceParaId: string | undefined;
   /** `paraId` minted for the right-column copy; stable across re-runs. */
@@ -10,7 +10,7 @@ type BilingualParagraphRef = {
   /** Plain text of the source paragraph. */
   sourceText: string;
 };
-type BilingualRow = ({
+export type BilingualRow = ({
   kind: BilingualRowKind;
   /** Equals `targetParaId`; the handle callers use to address the row. */
   rowId: string;
@@ -31,14 +31,14 @@ type BilingualRow = ({
   /** Source/target paragraph pairs in table document order. */
   paragraphs: BilingualParagraphRef[];
 };
-type BilingualTableParagraphRef = {
+export type BilingualTableParagraphRef = {
   paraId: string | undefined;
   sourceText: string;
 };
-type BilingualBorders = "none" | "grid";
-declare const BILINGUAL_TABLE_LAYOUTS: readonly ["inline", "stacked"];
-type BilingualTableLayout = (typeof BILINGUAL_TABLE_LAYOUTS)[number];
-type CreateBilingualDocumentOptions = {
+export type BilingualBorders = "none" | "grid";
+export declare const BILINGUAL_TABLE_LAYOUTS: readonly ["inline", "stacked"];
+export type BilingualTableLayout = (typeof BILINGUAL_TABLE_LAYOUTS)[number];
+export type CreateBilingualDocumentOptions = {
   /**
    * Suffix for cloned style ids and names (for example `"en"` turns
    * `Heading1` into `Heading1-en`). Must be a non-empty token of letters,
@@ -60,18 +60,18 @@ type CreateBilingualDocumentOptions = {
    */
   editableParagraphIds: ReadonlySet<string>;
 };
-type CreateBilingualDocumentResult = {
+export type CreateBilingualDocumentResult = {
   document: document_d_exports.Document;
   rows: BilingualRow[];
   /** Non-fatal fidelity notes (for example an unresolvable numbering style link). */
   warnings: string[];
 };
 declare const InvalidBilingualDocumentOptionsError_base: import("better-result").TaggedErrorClass<"InvalidBilingualDocumentOptionsError">;
-declare class InvalidBilingualDocumentOptionsError extends InvalidBilingualDocumentOptionsError_base<{
+export declare class InvalidBilingualDocumentOptionsError extends InvalidBilingualDocumentOptionsError_base<{
   message: string;
   option: "tableLayout" | "targetStyleSuffix";
 }> {}
-declare function createBilingualDocument(source: document_d_exports.Document, options: CreateBilingualDocumentOptions): CreateBilingualDocumentResult;
+export declare function createBilingualDocument(source: document_d_exports.Document, options: CreateBilingualDocumentOptions): CreateBilingualDocumentResult;
 /**
  * Re-derive the row manifest from a document produced by
  * {@link createBilingualDocument}. A dedicated table-style discriminator keeps
@@ -79,6 +79,6 @@ declare function createBilingualDocument(source: document_d_exports.Document, op
  * the expected row structure is validated as a second check. Rows are returned
  * in document order.
  */
-declare function readBilingualDocument(document: document_d_exports.Document, editableParagraphIds: ReadonlySet<string>): BilingualRow[];
+export declare function readBilingualDocument(document: document_d_exports.Document, editableParagraphIds: ReadonlySet<string>): BilingualRow[];
 //#endregion
-export { BILINGUAL_TABLE_LAYOUTS, BilingualBorders, BilingualParagraphRef, BilingualRow, BilingualRowKind, BilingualTableLayout, BilingualTableParagraphRef, CreateBilingualDocumentOptions, CreateBilingualDocumentResult, InvalidBilingualDocumentOptionsError, createBilingualDocument, readBilingualDocument };
+export {};

package/dist/docx/server/createBilingualDocument.js

@@ -1,12 +1,15 @@
+import { resolveParagraphList } from "../../prosemirror/paragraphList.js";
 import { deterministicHexId } from "../../utils/hexId.js";
 import { createBookmarkIdAllocator } from "../bookmarkIds.js";
 import { createBuiltInStyleIndex, resolveHeadingLevel } from "../builtInStyles.js";
 import { createNumberingIdAllocator } from "../numberingIds.js";
-import { mergeParagraphNumbering, paragraphNumberingReference, paragraphNumberingReferenceId } from "../numberingReference.js";
+import { getCachedNumberingMap } from "../numberingParser.js";
+import { mergeParagraphNumbering as mergeParagraphNumbering$1, paragraphNumberingReference as paragraphNumberingReference$1, paragraphNumberingReferenceId } from "../numberingReference.js";
 import { getParagraphText } from "../paragraphParser.js";
 import { cloneParagraphWithoutPropertySource } from "../paragraphPropertySource.js";
 import { getRunText } from "../runParser.js";
 import { TaggedError, panic } from "better-result";
+import { finalizeParagraphFormatting } from "@stll/docx-core/model";
 //#region src/docx/server/createBilingualDocument.ts
 /**
 * Bilingual document transform: body -> two-column table, one row per block.
@@ -79,6 +82,7 @@ function createBilingualDocument(source, options) {
 	const warnings = [];
 	const styles = source.package.styles;
 	const numbering = source.package.numbering;
+	const numberingMap = numbering ? getCachedNumberingMap(numbering) : null;
 	const styleById = new Map((styles?.styles ?? []).map((style) => [style.styleId, style]));
 	const builtInStyles = createBuiltInStyleIndex(styleById.values(), styles?.docDefaults);
 	const blocks = flattenBlocks(source.package.document.content);
@@ -128,7 +132,7 @@ function createBilingualDocument(source, options) {
 			}
 			const { copy, ref } = copyParagraph(block);
 			rows.push({
-				kind: classifyParagraph(block, styleById, builtInStyles),
+				kind: classifyParagraph(block, styleById, builtInStyles, numberingMap),
 				rowId: ref.targetParaId,
 				...ref
 			});
@@ -189,7 +193,7 @@ function createBilingualDocument(source, options) {
 				...source.package,
 				document: {
 					...source.package.document,
-					content
+					content: content.map(canonicalizeBlockParagraphFormatting)
 				},
 				...cloner.hasClones() && { numbering: cloner.toDefinitions() },
 				...styleCloner.hasClones() && styles && { styles: styleCloner.toDefinitions(styles) }
@@ -199,6 +203,29 @@ function createBilingualDocument(source, options) {
 		warnings
 	};
 }
+const canonicalizeBlockParagraphFormatting = (block) => {
+	if (block.type === "paragraph") {
+		const formatting = finalizeParagraphFormatting(block.formatting);
+		const paragraph = cloneParagraphWithoutPropertySource(block, { ...formatting !== void 0 && { formatting } });
+		if (formatting === void 0) delete paragraph.formatting;
+		return paragraph;
+	}
+	if (block.type === "table") return {
+		...block,
+		rows: block.rows.map((row) => ({
+			...row,
+			cells: row.cells.map((cell) => ({
+				...cell,
+				content: cell.content.map(canonicalizeBlockParagraphFormatting)
+			}))
+		}))
+	};
+	if (block.type === "blockSdt" || block.type === "blockCustomXml") return {
+		...block,
+		content: block.content.map(canonicalizeBlockParagraphFormatting)
+	};
+	return block;
+};
 /** Handle for a table row whose paragraphs carry no `paraId`: its position in
 *  the manifest, which creation and reading derive identically. */
 const tableRowHandle = (index) => `table-${index}`;
@@ -212,6 +239,10 @@ const flattenBlocks = (content) => {
 			case "preservedBlock":
 			case "bookmarkStart":
 			case "bookmarkEnd":
+			case "moveFromRangeStart":
+			case "moveFromRangeEnd":
+			case "moveToRangeStart":
+			case "moveToRangeEnd":
 				out.push(block);
 				return;
 			case "blockSdt":
@@ -253,20 +284,18 @@ const isFieldOnlyParagraph = (paragraph) => {
 * them would surface as a missing handle rather than as the rule it is.
 */
 const isTranslatableParagraph = (paragraph, editableParagraphIds) => paragraph.paraId !== void 0 && editableParagraphIds.has(paragraph.paraId) && !isFieldOnlyParagraph(paragraph);
-const classifyParagraph = (paragraph, styleById, builtInStyles) => {
+const classifyParagraph = (paragraph, styleById, builtInStyles, numbering) => {
 	const formatting = paragraph.formatting;
 	if (resolveHeadingLevel({
 		outlineLevel: formatting?.outlineLevel,
 		styleId: formatting?.styleId
 	}, builtInStyles) !== void 0) return "heading";
-	if (effectiveNumPr(paragraph, styleById) !== void 0) return "listItem";
-	return "paragraph";
-};
-/** The numbering a paragraph renders with after style and direct tiers fold. */
-const effectiveNumPr = (paragraph, styleById) => {
 	const styleId = paragraph.formatting?.styleId;
-	const effective = mergeParagraphNumbering(styleId ? styleNumPr(styleById.get(styleId), styleById) : void 0, paragraph.formatting?.numPr);
-	return effective?.kind === "reference" ? effective : void 0;
+	if (resolveParagraphList({
+		numPr: paragraph.formatting?.numPr,
+		numPrFromStyle: styleId ? styleNumPr(styleById.get(styleId), styleById) : void 0
+	}, numbering).kind === "marker") return "listItem";
+	return "paragraph";
 };
 const styleNumPr = (style, styleById) => {
 	const seen = /* @__PURE__ */ new Set();
@@ -278,8 +307,8 @@ const styleNumPr = (style, styleById) => {
 		current = current.basedOn ? styleById.get(current.basedOn) : void 0;
 	}
 	let effective;
-	for (const stated of chain.toReversed()) effective = mergeParagraphNumbering(effective, stated);
-	return effective?.kind === "reference" ? effective : void 0;
+	for (const stated of chain.toReversed()) effective = mergeParagraphNumbering$1(effective, stated);
+	return effective;
 };
 const createNumberingCloner = ({ numbering, styleById, warnings }) => {
 	const abstractNums = numbering?.abstractNums ?? [];
@@ -317,7 +346,8 @@ const createNumberingCloner = ({ numbering, styleById, warnings }) => {
 		let current = abstract;
 		while (current.numStyleLink && !seen.has(current.abstractNumId)) {
 			seen.add(current.abstractNumId);
-			const linkedNumId = paragraphNumberingReferenceId(styleById.get(current.numStyleLink)?.pPr?.numPr);
+			const linkedStyle = styleById.get(current.numStyleLink);
+			const linkedNumId = paragraphNumberingReferenceId(linkedStyle?.pPr?.numPr);
 			const linkedNum = linkedNumId === void 0 ? void 0 : numById.get(linkedNumId);
 			const linkedAbstract = linkedNum ? abstractById.get(linkedNum.abstractNumId) : void 0;
 			if (!linkedAbstract) {
@@ -370,7 +400,7 @@ const createStyleCloner = ({ styleById, suffix, cloner }) => {
 		const style = styleById.get(styleId);
 		if (!style || style.type !== "paragraph") return styleId;
 		const numPr = styleNumPr(style, styleById);
-		if (numPr === void 0) return styleId;
+		if (numPr?.kind !== "reference") return styleId;
 		const cloneId = `${styleId}-${suffix}`;
 		if (styleById.has(cloneId)) return cloneId;
 		const clone = {
@@ -381,7 +411,7 @@ const createStyleCloner = ({ styleById, suffix, cloner }) => {
 			default: false,
 			pPr: {
 				...style.pPr,
-				numPr: paragraphNumberingReference({
+				numPr: paragraphNumberingReference$1({
 					numId: cloner.cloneNumId(numPr.numId),
 					ilvl: numPr.ilvl
 				})
@@ -401,7 +431,7 @@ const createStyleCloner = ({ styleById, suffix, cloner }) => {
 };
 const cloneParagraphForTarget = (paragraph, targetParaId, styleCloner, cloner, bookmarkIds) => {
 	const formatting = paragraph.formatting;
-	const nextFormatting = formatting && {
+	const nextFormatting = finalizeParagraphFormatting(formatting && {
 		...formatting,
 		...formatting.styleId !== void 0 && { styleId: styleCloner.styleIdFor(formatting.styleId) },
 		...formatting.numPr?.kind === "reference" && { numPr: {
@@ -412,13 +442,14 @@ const cloneParagraphForTarget = (paragraph, targetParaId, styleCloner, cloner, b
 			...formatting.numPrFromStyle,
 			numId: cloner.cloneNumId(formatting.numPrFromStyle.numId)
 		} }
-	};
+	});
 	const cloned = cloneParagraphWithoutPropertySource(paragraph, {
 		content: remapClonedBookmarkIds(structuredClone(paragraph.content), bookmarkIds),
 		paraId: targetParaId,
 		...nextFormatting && { formatting: nextFormatting },
 		...paragraph.listRendering && { listRendering: remapListRendering(paragraph.listRendering, cloner) }
 	});
+	if (nextFormatting === void 0) delete cloned.formatting;
 	Reflect.deleteProperty(cloned, "textId");
 	Reflect.deleteProperty(cloned, "sectionProperties");
 	return cloned;
@@ -573,7 +604,7 @@ const projectParagraphIntoColumn = (paragraph, geometry, sourceWidth, columnWidt
 		indentLeft = minimumLeftIndent + Math.round(flexibleLeft / flexibleTotal * flexibleMaximum);
 		indentRight = maxSideIndent - indentLeft;
 	}
-	return cloneParagraphWithoutPropertySource(paragraph, { formatting: {
+	const formatting = finalizeParagraphFormatting({
 		...paragraph.formatting,
 		...(geometry.indentLeft !== void 0 || minimumLeftIndent > 0) && { indentLeft },
 		...geometry.indentRight !== void 0 && { indentRight },
@@ -583,7 +614,10 @@ const projectParagraphIntoColumn = (paragraph, geometry, sourceWidth, columnWidt
 			...tab,
 			position: Math.min(Math.max(0, Math.round(tab.position * scale)), Math.max(0, columnWidth - MIN_TAB_TRAILING_WIDTH_TWIPS))
 		})) }
-	} });
+	});
+	const projected = cloneParagraphWithoutPropertySource(paragraph, { ...formatting && { formatting } });
+	if (formatting === void 0) delete projected.formatting;
+	return projected;
 };
 const projectSideIndent = (value, scale, maximum) => Math.min(Math.max(0, Math.round((value ?? 0) * scale)), maximum);
 const buildCell = (paragraph) => ({
@@ -722,6 +756,7 @@ const createParaIdMinter = (taken) => {
 function readBilingualDocument(document, editableParagraphIds) {
 	const styleById = new Map((document.package.styles?.styles ?? []).map((style) => [style.styleId, style]));
 	const builtInStyles = createBuiltInStyleIndex(styleById.values(), document.package.styles?.docDefaults);
+	const numberingMap = document.package.numbering ? getCachedNumberingMap(document.package.numbering) : null;
 	const rows = [];
 	let missingHandleCount = 0;
 	for (const block of flattenBlocks(document.package.document.content)) {
@@ -796,7 +831,7 @@ function readBilingualDocument(document, editableParagraphIds) {
 			if (targetMissing) missingHandleCount += 1;
 			if (sourceMissing || targetMissing) continue;
 			rows.push({
-				kind: classifyParagraph(source, styleById, builtInStyles),
+				kind: classifyParagraph(source, styleById, builtInStyles, numberingMap),
 				rowId: target.paraId,
 				sourceParaId: source.paraId,
 				targetParaId: target.paraId,

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

@@ -1,7 +1,7 @@
 import { BilingualRow, CreateBilingualDocumentOptions } from "./createBilingualDocument.js";
 //#region src/docx/server/createBilingualDocx.d.ts
-type CreateBilingualDocxOptions = Omit<CreateBilingualDocumentOptions, "editableParagraphIds">;
-type CreateBilingualDocxResult = {
+export type CreateBilingualDocxOptions = Omit<CreateBilingualDocumentOptions, "editableParagraphIds">;
+export type CreateBilingualDocxResult = {
   buffer: ArrayBuffer;
   rows: BilingualRow[];
   warnings: string[];
@@ -13,8 +13,7 @@ type CreateBilingualDocxResult = {
  * as a two-column table, and repack onto the original package so theme, fonts,
  * media, headers and footers carry over untouched.
  */
-declare function createBilingualDocx(input: ArrayBuffer | Uint8Array, options: CreateBilingualDocxOptions): Promise<CreateBilingualDocxResult>;
+export declare function createBilingualDocx(input: ArrayBuffer | Uint8Array, options: CreateBilingualDocxOptions): Promise<CreateBilingualDocxResult>;
 /** Bytes-in form of {@link readBilingualDocument}. */
-declare function readBilingualDocx(input: ArrayBuffer | Uint8Array): Promise<BilingualRow[]>;
-//#endregion
-export { CreateBilingualDocxOptions, CreateBilingualDocxResult, createBilingualDocx, readBilingualDocx };
+export declare function readBilingualDocx(input: ArrayBuffer | Uint8Array): Promise<BilingualRow[]>;
+//#endregion

package/dist/docx/server/createBilingualDocx.js

@@ -14,9 +14,11 @@ import { createBilingualDocument, readBilingualDocument } from "./createBilingua
 * media, headers and footers carry over untouched.
 */
 async function createBilingualDocx(input, options) {
-	const stampedBuffer = await toArrayBuffer((await ensureParaIds(input)).docx);
+	const stamped = await ensureParaIds(input);
+	const stampedBuffer = await toArrayBuffer(stamped.docx);
 	const editableParagraphIds = new Set((await FolioDocxReviewer.fromBuffer(stampedBuffer)).snapshot().blocks.filter(isFolioAIContentBlock).map(({ id }) => id));
-	const { document, warnings } = createBilingualDocument(await parseDocx(stampedBuffer, { preloadFonts: false }), {
+	const source = await parseDocx(stampedBuffer, { preloadFonts: false });
+	const { document, warnings } = createBilingualDocument(source, {
 		...options,
 		editableParagraphIds
 	});
@@ -30,7 +32,9 @@ async function createBilingualDocx(input, options) {
 /** Bytes-in form of {@link readBilingualDocument}. */
 async function readBilingualDocx(input) {
 	const buffer = await toArrayBuffer(input);
-	return readBilingualDocument(await parseDocx(buffer, { preloadFonts: false }), new Set((await FolioDocxReviewer.fromBuffer(buffer)).snapshot().blocks.filter(isFolioAIContentBlock).map(({ id }) => id)));
+	const document = await parseDocx(buffer, { preloadFonts: false });
+	const editableParagraphIds = new Set((await FolioDocxReviewer.fromBuffer(buffer)).snapshot().blocks.filter(isFolioAIContentBlock).map(({ id }) => id));
+	return readBilingualDocument(document, editableParagraphIds);
 }
 //#endregion
 export { createBilingualDocx, readBilingualDocx };

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

@@ -9,6 +9,5 @@ import { MarkdownOptions } from "../../markdown/types.js";
  * tables, lists, and content controls (`w:sdt`) at every position — without
  * deep-importing internal subpaths or re-implementing an OOXML walker.
  */
-declare function docxToMarkdown(input: ArrayBuffer | Uint8Array, opts?: MarkdownOptions): Promise<string>;
-//#endregion
-export { docxToMarkdown };
+export declare function docxToMarkdown(input: ArrayBuffer | Uint8Array, opts?: MarkdownOptions): Promise<string>;
+//#endregion

package/dist/docx/server/docxToMarkdown.js

@@ -11,7 +11,8 @@ import { parseDocx } from "../parser.js";
 * deep-importing internal subpaths or re-implementing an OOXML walker.
 */
 async function docxToMarkdown(input, opts) {
-	return toMarkdown(await parseDocx(input, { preloadFonts: false }), opts);
+	const doc = await parseDocx(input, { preloadFonts: false });
+	return toMarkdown(doc, opts);
 }
 //#endregion
 export { docxToMarkdown };

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

@@ -1,29 +1,29 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
 //#region src/docx/server/evaluateDocxXmlPatchProposal.d.ts
-declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION: 1;
-declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE: "folio-xml-patch-proposal-v1";
-declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS: Readonly<{
+export declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION: 1;
+export declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE: "folio-xml-patch-proposal-v1";
+export declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS: Readonly<{
   readonly maxReplacements: 16;
   readonly maxPartBytes: number;
   readonly maxTotalBytes: number;
 }>;
-declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES: readonly ["invalid-proposal", "unsupported-version", "too-many-replacements", "duplicate-part", "invalid-part-path", "invalid-base-sha256", "part-not-allowed", "part-not-found", "part-not-xml", "replacement-too-large", "replacements-too-large", "xml-doctype-forbidden", "xml-not-well-formed", "xml-encoding-mismatch", "base-hash-mismatch", "package-inspection-failed"];
-type FolioDocxXmlPatchProposalIssueCode = (typeof FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES)[number];
-type FolioDocxXmlReplacement = {
+export declare const FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES: readonly ["invalid-proposal", "unsupported-version", "too-many-replacements", "duplicate-part", "invalid-part-path", "invalid-base-sha256", "part-not-allowed", "part-not-found", "part-not-xml", "replacement-too-large", "replacements-too-large", "xml-doctype-forbidden", "xml-not-well-formed", "xml-encoding-mismatch", "base-hash-mismatch", "package-inspection-failed"];
+export type FolioDocxXmlPatchProposalIssueCode = (typeof FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES)[number];
+export type FolioDocxXmlReplacement = {
   readonly path: string;
   readonly baseSha256: string;
   readonly replacementXml: string;
 };
-type FolioDocxXmlPatchProposal = {
+export type FolioDocxXmlPatchProposal = {
   readonly version: typeof FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION;
   readonly replacements: readonly [FolioDocxXmlReplacement, ...FolioDocxXmlReplacement[]];
 };
-type FolioDocxXmlPatchProposalLimits = {
+export type FolioDocxXmlPatchProposalLimits = {
   readonly maxReplacements?: number;
   readonly maxPartBytes?: number;
   readonly maxTotalBytes?: number;
 };
-type EvaluateDocxXmlPatchProposalArgs = {
+export type EvaluateDocxXmlPatchProposalArgs = {
   readonly bytes: ArrayBuffer | Uint8Array;
   readonly proposal: unknown;
   /** Exact package paths authorized by the server-side caller. */
@@ -31,13 +31,13 @@ type EvaluateDocxXmlPatchProposalArgs = {
   readonly archive?: DocxArchiveOptions;
   readonly limits?: FolioDocxXmlPatchProposalLimits;
 };
-type FolioDocxXmlPatchProposalIssue = {
+export type FolioDocxXmlPatchProposalIssue = {
   readonly code: FolioDocxXmlPatchProposalIssueCode;
   readonly message: string;
   readonly proposalPath?: string;
   readonly part?: string;
 };
-type FolioDocxPreparedXmlReplacement = {
+export type FolioDocxPreparedXmlReplacement = {
   readonly path: string;
   readonly baseSha256: string;
   readonly currentSha256: string;
@@ -45,7 +45,7 @@ type FolioDocxPreparedXmlReplacement = {
   readonly replacementByteLength: number;
   readonly encoding: "utf-8";
 };
-type FolioDocxXmlPatchProposalEvaluation = {
+export type FolioDocxXmlPatchProposalEvaluation = {
   readonly version: typeof FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION;
   readonly profile: typeof FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE;
   readonly status: "accepted";
@@ -63,17 +63,17 @@ type FolioDocxXmlPatchProposalEvaluation = {
   readonly limits: Required<FolioDocxXmlPatchProposalLimits>;
 };
 declare const InvalidFolioDocxXmlPatchProposalError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocxXmlPatchProposalError">;
-declare class InvalidFolioDocxXmlPatchProposalError extends InvalidFolioDocxXmlPatchProposalError_base<{
+export declare class InvalidFolioDocxXmlPatchProposalError extends InvalidFolioDocxXmlPatchProposalError_base<{
   message: string;
   path: string;
   reason: string;
 }> {}
 declare const InvalidFolioDocxXmlPatchProposalOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocxXmlPatchProposalOptionsError">;
-declare class InvalidFolioDocxXmlPatchProposalOptionsError extends InvalidFolioDocxXmlPatchProposalOptionsError_base<{
+export declare class InvalidFolioDocxXmlPatchProposalOptionsError extends InvalidFolioDocxXmlPatchProposalOptionsError_base<{
   message: string;
   path: string;
 }> {}
-declare const parseFolioDocxXmlPatchProposal: (value: unknown) => FolioDocxXmlPatchProposal;
-declare const evaluateDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, archive, limits: rawLimits }: EvaluateDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchProposalEvaluation>;
+export declare const parseFolioDocxXmlPatchProposal: (value: unknown) => FolioDocxXmlPatchProposal;
+export declare const evaluateDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, archive, limits: rawLimits }: EvaluateDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchProposalEvaluation>;
 //#endregion
-export { EvaluateDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FolioDocxPreparedXmlReplacement, FolioDocxXmlPatchProposal, FolioDocxXmlPatchProposalEvaluation, FolioDocxXmlPatchProposalIssue, FolioDocxXmlPatchProposalIssueCode, FolioDocxXmlPatchProposalLimits, FolioDocxXmlReplacement, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal };
+export {};

package/dist/docx/server/evaluateDocxXmlPatchProposal.js

@@ -9,8 +9,8 @@ const FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION = 1;
 const FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE = "folio-xml-patch-proposal-v1";
 const FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS = Object.freeze({
 	maxReplacements: 16,
-	maxPartBytes: 8 * 1024 * 1024,
-	maxTotalBytes: 16 * 1024 * 1024
+	maxPartBytes: 8388608,
+	maxTotalBytes: 16777216
 });
 const FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES = Object.freeze([
 	"invalid-proposal",

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

@@ -1,7 +1,7 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
 //#region src/docx/server/extractDocxText.d.ts
 /** Document part containing an extracted paragraph. */
-type DocxParagraphSource = "header" | "body" | "footer";
+export type DocxParagraphSource = "header" | "body" | "footer";
 /**
  * Role of an emitted markdown table row.
  *
@@ -11,9 +11,9 @@ type DocxParagraphSource = "header" | "body" | "footer";
  *   no header row; GFM has no headerless table.
  * - `delimiter` — the `| --- |` line GFM requires under the header.
  */
-type DocxTableRowKind = "cells" | "syntheticHeader" | "delimiter";
+export type DocxTableRowKind = "cells" | "syntheticHeader" | "delimiter";
 /** Source paragraph inside a structured table cell. */
-type ExtractedDocxTableCellParagraph = {
+export type ExtractedDocxTableCellParagraph = {
   text: string;
   style?: string;
   bold?: boolean;
@@ -21,12 +21,12 @@ type ExtractedDocxTableCellParagraph = {
   alignment?: "left" | "center" | "right" | "both";
 };
 /** Source paragraphs contained by one physical table cell. */
-type ExtractedDocxTableCell = {
+export type ExtractedDocxTableCell = {
   /** Source `w:p` records in document order; empty padding cells have no entries. */
   paragraphs: readonly ExtractedDocxTableCellParagraph[];
 };
 /** Table membership of a paragraph whose `text` is a markdown table row. */
-type DocxTableRowPosition = {
+export type DocxTableRowPosition = {
   /** 0-based index of the source `w:tbl`, in extraction order across all parts. */
   table: number;
   kind: "cells";
@@ -38,7 +38,7 @@ type DocxTableRowPosition = {
   kind: "syntheticHeader" | "delimiter";
 };
 /** Paragraph text and lightweight formatting metadata from a DOCX archive. */
-type ExtractedDocxParagraph = {
+export type ExtractedDocxParagraph = {
   index: number;
   text: string;
   source: DocxParagraphSource;
@@ -55,17 +55,16 @@ type ExtractedDocxParagraph = {
   tableRow?: DocxTableRowPosition;
 };
 /** Accepted-revision paragraph text extracted in deterministic part order. */
-type ExtractedDocxText = {
+export type ExtractedDocxText = {
   paragraphs: ExtractedDocxParagraph[];
   charCount: number;
   view: "accepted";
 };
 /** Options for {@link extractDocxText}. */
-type ExtractDocxTextOptions = {
+export type ExtractDocxTextOptions = {
   /** Archive limits, applied before and while each part is inflated. */
   readonly archive?: DocxArchiveOptions;
 };
 /** Extract paragraph text and formatting metadata from a DOCX archive. */
-declare const extractDocxText: (bytes: ArrayBuffer | Uint8Array, options?: ExtractDocxTextOptions) => Promise<ExtractedDocxText>;
-//#endregion
-export { DocxParagraphSource, DocxTableRowKind, DocxTableRowPosition, ExtractDocxTextOptions, ExtractedDocxParagraph, ExtractedDocxTableCell, ExtractedDocxTableCellParagraph, ExtractedDocxText, extractDocxText };
+export declare const extractDocxText: (bytes: ArrayBuffer | Uint8Array, options?: ExtractDocxTextOptions) => Promise<ExtractedDocxText>;
+//#endregion

package/dist/docx/server/extractDocxText.js

@@ -107,7 +107,7 @@ const MAX_NESTED_TABLE_DEPTH = 8;
 /** Rows collected from one `w:tbl`. The column cap alone leaves row count unbounded. */
 const MAX_TABLE_ROWS = 8192;
 /** Source and rendered characters retained across every table in one extraction. */
-const MAX_TABLE_CHARACTERS = 8 * 1024 * 1024;
+const MAX_TABLE_CHARACTERS = 8388608;
 const createTableExtractionBudget = () => ({
 	remainingSourceCharacters: MAX_TABLE_CHARACTERS,
 	remainingRenderedCharacters: MAX_TABLE_CHARACTERS
@@ -433,7 +433,8 @@ const extractParts = async ({ archive, source, rootName, startIndex, startTableI
 	for (const path of paths) {
 		const xml = await archive.readEntryString(path);
 		if (xml === null) continue;
-		const container = findDeep(parseXml(xml), "w", rootName);
+		const root = parseXml(xml);
+		const container = findDeep(root, "w", rootName);
 		if (!container) continue;
 		const result = extractContainer({
 			container,

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

@@ -1,38 +1,38 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
 //#region src/docx/server/inspectDocxPackage.d.ts
-declare const FOLIO_DOCX_PACKAGE_INSPECTION_VERSION: 1;
-declare const FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS: Readonly<{
+export declare const FOLIO_DOCX_PACKAGE_INSPECTION_VERSION: 1;
+export declare const FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS: Readonly<{
   readonly maxXmlParts: 16;
   readonly maxXmlPartBytes: number;
   readonly maxXmlTotalBytes: number;
 }>;
-declare const FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES: readonly ["invalid-limits", "too-many-xml-parts", "duplicate-xml-part", "part-not-found", "part-not-xml", "xml-part-too-large", "xml-total-too-large", "xml-decode-failed"];
-type FolioDocxPackageInspectionErrorCode = (typeof FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES)[number];
+export declare const FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES: readonly ["invalid-limits", "too-many-xml-parts", "duplicate-xml-part", "part-not-found", "part-not-xml", "xml-part-too-large", "xml-total-too-large", "xml-decode-failed"];
+export type FolioDocxPackageInspectionErrorCode = (typeof FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES)[number];
 declare const FolioDocxPackageInspectionError_base: import("better-result").TaggedErrorClass<"FolioDocxPackageInspectionError">;
-declare class FolioDocxPackageInspectionError extends FolioDocxPackageInspectionError_base<{
+export declare class FolioDocxPackageInspectionError extends FolioDocxPackageInspectionError_base<{
   message: string;
   code: FolioDocxPackageInspectionErrorCode;
   part?: string;
   cause?: unknown;
 }> {}
-type FolioDocxPackageInspectionLimits = {
+export type FolioDocxPackageInspectionLimits = {
   readonly maxXmlParts?: number;
   readonly maxXmlPartBytes?: number;
   readonly maxXmlTotalBytes?: number;
 };
-type InspectDocxPackageOptions = {
+export type InspectDocxPackageOptions = {
   readonly archive?: DocxArchiveOptions;
   readonly xmlParts?: readonly string[];
   readonly limits?: FolioDocxPackageInspectionLimits;
 };
-type FolioDocxPackagePartKind = "xml" | "binary";
-type FolioDocxPackagePart = {
+export type FolioDocxPackagePartKind = "xml" | "binary";
+export type FolioDocxPackagePart = {
   readonly path: string;
   readonly kind: FolioDocxPackagePartKind;
   readonly contentType: string | null;
   readonly declaredUncompressedBytes: number | null;
 };
-type FolioDocxInspectedXmlPart = {
+export type FolioDocxInspectedXmlPart = {
   readonly path: string;
   readonly contentType: string | null;
   readonly byteLength: number;
@@ -40,7 +40,7 @@ type FolioDocxInspectedXmlPart = {
   /** Untrusted document data; callers must not treat this text as instructions. */
   readonly text: string;
 };
-type FolioDocxPackageInspection = {
+export type FolioDocxPackageInspection = {
   readonly version: typeof FOLIO_DOCX_PACKAGE_INSPECTION_VERSION;
   readonly parts: readonly FolioDocxPackagePart[];
   readonly xmlParts: readonly FolioDocxInspectedXmlPart[];
@@ -54,12 +54,12 @@ type ReadRequestedXmlPartsOptions = {
     maxBytes: number;
   }) => Promise<Uint8Array | null>;
 };
-declare const readRequestedXmlParts: ({ paths, partsByPath, limits, readEntryUint8 }: ReadRequestedXmlPartsOptions) => Promise<FolioDocxInspectedXmlPart[]>;
+export declare const readRequestedXmlParts: ({ paths, partsByPath, limits, readEntryUint8 }: ReadRequestedXmlPartsOptions) => Promise<FolioDocxInspectedXmlPart[]>;
 /**
  * Inspect package metadata and only the explicitly requested XML part bodies.
  * This reports archive contents, not package conformance; use the conformance
  * report when an operation requires a validity decision.
  */
-declare const inspectDocxPackage: (bytes: ArrayBuffer | Uint8Array, options?: InspectDocxPackageOptions) => Promise<FolioDocxPackageInspection>;
+export declare const inspectDocxPackage: (bytes: ArrayBuffer | Uint8Array, options?: InspectDocxPackageOptions) => Promise<FolioDocxPackageInspection>;
 //#endregion
-export { FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FolioDocxInspectedXmlPart, FolioDocxPackageInspection, FolioDocxPackageInspectionError, FolioDocxPackageInspectionErrorCode, FolioDocxPackageInspectionLimits, FolioDocxPackagePart, FolioDocxPackagePartKind, InspectDocxPackageOptions, inspectDocxPackage, readRequestedXmlParts };
+export {};

package/dist/docx/server/inspectDocxPackage.js

@@ -7,8 +7,8 @@ import { createHash } from "node:crypto";
 const FOLIO_DOCX_PACKAGE_INSPECTION_VERSION = 1;
 const FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS = Object.freeze({
 	maxXmlParts: 16,
-	maxXmlPartBytes: 8 * 1024 * 1024,
-	maxXmlTotalBytes: 16 * 1024 * 1024
+	maxXmlPartBytes: 8388608,
+	maxXmlTotalBytes: 16777216
 });
 const FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES = Object.freeze([
 	"invalid-limits",
@@ -22,7 +22,7 @@ const FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES = Object.freeze([
 ]);
 var FolioDocxPackageInspectionError = class extends TaggedError("FolioDocxPackageInspectionError") {};
 const CONTENT_TYPES_PATH = "[Content_Types].xml";
-const CONTENT_TYPES_READ_LIMIT = 4 * 1024 * 1024;
+const CONTENT_TYPES_READ_LIMIT = 4194304;
 const XML_PATH_PATTERN = /(?:\.xml|\.rels)$/iu;
 const XML_CONTENT_TYPES = /* @__PURE__ */ new Set(["application/xml", "text/xml"]);
 const comparePackagePaths = (left, right) => {