@stll/folio-core 0.61.0 → 0.63.0

package/dist/docx/serializer/xmlUtils.d.ts

@@ -14,7 +14,7 @@
  * `NaN`/`Infinity`/`null`/`undefined` collapse to `'0'` rather than leaking
  * literal `"NaN"` or `"Infinity"` into the XML.
  */
-declare function intAttr(value: number | undefined | null): string;
+export declare function intAttr(value: number | undefined | null): string;
 /**
  * Verify that `xml` parses to exactly one root element named `expectedLocalName`
  * (namespace prefix ignored). Used to gate raw XML snapshots — e.g. an SDT's
@@ -26,6 +26,5 @@ declare function intAttr(value: number | undefined | null): string;
  * sibling markup or close the enclosing `<w:sdt>` early. Callers should fall
  * back to a synthesized properties block when this returns `false`.
  */
-declare function isSingleWellFormedElement(xml: string, expectedLocalName: string): boolean;
-//#endregion
-export { intAttr, isSingleWellFormedElement };
+export declare function isSingleWellFormedElement(xml: string, expectedLocalName: string): boolean;
+//#endregion

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

@@ -2,9 +2,9 @@ import { DocxArchiveOptions } from "./boundedArchive.js";
 import { FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FolioDocxPreparedXmlReplacement, FolioDocxXmlPatchProposalEvaluation, FolioDocxXmlPatchProposalLimits } from "./evaluateDocxXmlPatchProposal.js";
 import { FOLIO_DOCX_CONFORMANCE_PROFILE, FolioDocxConformanceReport } from "./validateDocxConformance.js";
 //#region src/docx/server/applyDocxXmlPatchProposal.d.ts
-declare const FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION: 1;
-declare const FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE: "folio-xml-patch-application-v1";
-type ApplyDocxXmlPatchProposalArgs = {
+export declare const FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION: 1;
+export declare const FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE: "folio-xml-patch-application-v1";
+export type ApplyDocxXmlPatchProposalArgs = {
   readonly bytes: ArrayBuffer | Uint8Array;
   readonly proposal: unknown;
   /** Exact package paths authorized by the server-side caller. */
@@ -13,7 +13,7 @@ type ApplyDocxXmlPatchProposalArgs = {
   readonly archive?: DocxArchiveOptions;
   readonly limits?: FolioDocxXmlPatchProposalLimits;
 };
-type FolioDocxXmlPatchApplicationReceipt = {
+export type FolioDocxXmlPatchApplicationReceipt = {
   readonly version: typeof FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION;
   readonly profile: typeof FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE;
   readonly proposalProfile: typeof FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE;
@@ -28,7 +28,7 @@ type FolioDocxXmlPatchApplicationReceipt = {
   };
   readonly replacements: readonly [FolioDocxPreparedXmlReplacement, ...FolioDocxPreparedXmlReplacement[]];
 };
-type FolioDocxXmlPatchApplication = {
+export type FolioDocxXmlPatchApplication = {
   readonly version: typeof FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION;
   readonly profile: typeof FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE;
   readonly status: "proposal-rejected";
@@ -63,18 +63,18 @@ type FolioDocxXmlPatchApplication = {
   readonly bytes: Uint8Array;
 };
 declare const UnsupportedFolioDocxXmlPatchApplicationProfileError_base: import("better-result").TaggedErrorClass<"UnsupportedFolioDocxXmlPatchApplicationProfileError">;
-declare class UnsupportedFolioDocxXmlPatchApplicationProfileError extends UnsupportedFolioDocxXmlPatchApplicationProfileError_base<{
+export declare class UnsupportedFolioDocxXmlPatchApplicationProfileError extends UnsupportedFolioDocxXmlPatchApplicationProfileError_base<{
   message: string;
   profile: unknown;
 }> {}
 declare const FolioDocxXmlPatchApplicationError_base: import("better-result").TaggedErrorClass<"FolioDocxXmlPatchApplicationError">;
-declare class FolioDocxXmlPatchApplicationError extends FolioDocxXmlPatchApplicationError_base<{
+export declare class FolioDocxXmlPatchApplicationError extends FolioDocxXmlPatchApplicationError_base<{
   message: string;
   stage: "verify" | "load" | "replace" | "generate";
   part?: string;
   cause?: unknown;
 }> {}
 /** Apply a guarded XML proposal and return output only after full profile validation. */
-declare const applyDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, validationProfile, archive, limits }: ApplyDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchApplication>;
+export declare const applyDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, validationProfile, archive, limits }: ApplyDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchApplication>;
 //#endregion
-export { ApplyDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, FolioDocxXmlPatchApplicationReceipt, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal };
+export {};

package/dist/docx/server/applyDocxXmlPatchProposal.js

@@ -4,8 +4,8 @@ import { FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, InvalidFolioDocxXmlPatchProposal
 import { FOLIO_DOCX_CONFORMANCE_PROFILE, validateDocxConformance } from "./validateDocxConformance.js";
 import { TaggedError, panic } from "better-result";
 import { createHash } from "node:crypto";
-import { writeZipPart } from "@stll/docx-core/zip";
 import JSZip from "jszip";
+import { writeZipPart } from "@stll/docx-core/zip";
 //#region src/docx/server/applyDocxXmlPatchProposal.ts
 const FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION = 1;
 const FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE = "folio-xml-patch-application-v1";

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

@@ -1,17 +1,17 @@
 import { XmlResourceLimits } from "../xmlResourceLimits.js";
 //#region src/docx/server/boundedArchive.d.ts
-declare const DOCX_MAX_ENTRY_BYTES: number;
-declare const DOCX_MAX_TOTAL_BYTES: number;
-declare const DOCX_MAX_ENTRIES = 4096;
-declare const DOCX_MAX_INPUT_BYTES: number;
+export declare const DOCX_MAX_ENTRY_BYTES: number;
+export declare const DOCX_MAX_TOTAL_BYTES: number;
+export declare const DOCX_MAX_ENTRIES = 4096;
+export declare const DOCX_MAX_INPUT_BYTES: number;
 declare const DocxArchiveError_base: import("better-result").TaggedErrorClass<"DocxArchiveError">;
 /** Error raised when a DOCX archive cannot be loaded within configured limits. */
-declare class DocxArchiveError extends DocxArchiveError_base<{
+export declare class DocxArchiveError extends DocxArchiveError_base<{
   message: string;
   reason: "load-failed" | "input-too-large" | "too-many-entries" | "entry-too-large" | "total-too-large" | "compression-ratio-exceeded" | "invalid-options";
   cause?: unknown;
 }> {}
-type DocxArchiveOptions = {
+export type DocxArchiveOptions = {
   maxInputBytes?: number;
   maxEntryBytes?: number;
   maxTotalBytes?: number;
@@ -35,20 +35,20 @@ type DocxArchiveOptions = {
    */
   xmlLimits?: Partial<XmlResourceLimits>;
 };
-type DocxArchiveEntry = {
+export type DocxArchiveEntry = {
   readonly path: string;
   readonly directory: boolean;
   readonly declaredUncompressedBytes: number | null;
 };
-type DocxArchiveReadOptions = {
+export type DocxArchiveReadOptions = {
   maxBytes?: number;
 };
-type DocxArchive = {
+export type DocxArchive = {
   entries: readonly string[];
   entryMetadata: readonly DocxArchiveEntry[];
   readEntryString: (path: string) => Promise<string | null>;
   readEntryUint8: (path: string, options?: DocxArchiveReadOptions) => Promise<Uint8Array | null>;
 };
-declare const loadDocxArchive: (bytes: ArrayBuffer | Uint8Array, options?: DocxArchiveOptions) => Promise<DocxArchive>;
+export declare const loadDocxArchive: (bytes: ArrayBuffer | Uint8Array, options?: DocxArchiveOptions) => Promise<DocxArchive>;
 //#endregion
-export { DOCX_MAX_ENTRIES, DOCX_MAX_ENTRY_BYTES, DOCX_MAX_INPUT_BYTES, DOCX_MAX_TOTAL_BYTES, DocxArchive, DocxArchiveEntry, DocxArchiveError, DocxArchiveOptions, DocxArchiveReadOptions, loadDocxArchive };
+export {};

package/dist/docx/server/boundedArchive.js

@@ -4,10 +4,10 @@ import { FOLIO_XML_RESOURCE_LIMITS, assertXmlResourceLimits, createXmlPackageBud
 import { TaggedError } from "better-result";
 import JSZip from "jszip";
 //#region src/docx/server/boundedArchive.ts
-const DOCX_MAX_ENTRY_BYTES = 128 * 1024 * 1024;
-const DOCX_MAX_TOTAL_BYTES = 256 * 1024 * 1024;
+const DOCX_MAX_ENTRY_BYTES = 134217728;
+const DOCX_MAX_TOTAL_BYTES = 268435456;
 const DOCX_MAX_ENTRIES = 4096;
-const DOCX_MAX_INPUT_BYTES = 50 * 1024 * 1024;
+const DOCX_MAX_INPUT_BYTES = 52428800;
 /** Error raised when a DOCX archive cannot be loaded within configured limits. */
 var DocxArchiveError = class extends TaggedError("DocxArchiveError") {};
 const readLimitError = ({ limit, path, maxEntryBytes, maxTotalBytes, maxCompressionRatio }) => {

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

@@ -3,28 +3,28 @@ import { document_d_exports } from "../../types/document.js";
 import { ParagraphFormatting, TextFormatting } from "../../types/formatting.js";
 import { Hyperlink, Paragraph, ParagraphContent, Run, Table } from "../../types/content.js";
 //#region src/docx/server/build.d.ts
-declare const HEADING_LEVELS: readonly [1, 2, 3, 4, 5, 6];
-type HeadingLevel = (typeof HEADING_LEVELS)[number];
+export declare const HEADING_LEVELS: readonly [1, 2, 3, 4, 5, 6];
+export type HeadingLevel = (typeof HEADING_LEVELS)[number];
 declare const InvalidFolioReportBuilderOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioReportBuilderOptionsError">;
 /**
  * A builder received a value outside the model's domain (a zero `gridSpan`,
  * a negative column width, a reversed TOC range). Thrown at the boundary so
  * the invalid value never reaches the serializer.
  */
-declare class InvalidFolioReportBuilderOptionsError extends InvalidFolioReportBuilderOptionsError_base<{
+export declare class InvalidFolioReportBuilderOptionsError extends InvalidFolioReportBuilderOptionsError_base<{
   message: string;
   path: string;
 }> {}
-declare const run: (text: string, formatting?: TextFormatting) => Run;
-declare const paragraph: (content: string | ParagraphContent[], formatting?: ParagraphFormatting) => Paragraph;
+export declare const run: (text: string, formatting?: TextFormatting) => Run;
+export declare const paragraph: (content: string | ParagraphContent[], formatting?: ParagraphFormatting) => Paragraph;
 type HeadingOptions = {
   text: string;
   level: HeadingLevel;
 };
 /** A paragraph in the `Heading<level>` style. */
-declare const heading: ({ text, level }: HeadingOptions) => Paragraph;
+export declare const heading: ({ text, level }: HeadingOptions) => Paragraph;
 /** An empty paragraph carrying a hard page break. */
-declare const pageBreak: () => Paragraph;
+export declare const pageBreak: () => Paragraph;
 type HyperlinkTarget = {
   href: string;
   anchor?: never;
@@ -41,7 +41,7 @@ type HyperlinkOptions = HyperlinkTarget & {
  * An external (`href`) or in-document (`anchor`, a bookmark name) link. The
  * relationship for an external link is minted when the document is written.
  */
-declare const hyperlink: ({ text, formatting, tooltip, href, anchor }: HyperlinkOptions) => Hyperlink;
+export declare const hyperlink: ({ text, formatting, tooltip, href, anchor }: HyperlinkOptions) => Hyperlink;
 type BookmarkOptions = {
   name: string;
   content: ParagraphContent[];
@@ -53,8 +53,8 @@ type BookmarkOptions = {
   id?: number;
 };
 /** `content` wrapped in a named bookmark, the target of `hyperlink({ anchor })`. */
-declare const bookmark: ({ name, content, id }: BookmarkOptions) => ParagraphContent[];
-type TableCellSpec = string | {
+export declare const bookmark: ({ name, content, id }: BookmarkOptions) => ParagraphContent[];
+export type TableCellSpec = string | {
   content: Paragraph[];
   shading?: ShadingProperties;
   gridSpan?: number;
@@ -75,13 +75,13 @@ type TableOptions = {
  * plain paragraph; an object cell supplies its own paragraphs plus optional
  * shading and horizontal (`gridSpan`) or vertical (`vMerge`) merge.
  */
-declare const table: ({ header, rows, columnWidths, headerShading, repeatHeader }: TableOptions) => Table;
+export declare const table: ({ header, rows, columnWidths, headerShading, repeatHeader }: TableOptions) => Table;
 /**
  * Register an endnote on `doc` and return the reference run to place in body
  * text. Allocates the next free endnote id (Word reserves 0 and -1 for the
  * separator notes) and pushes the note into `doc.package.endnotes`.
  */
-declare const endnote: (doc: document_d_exports.Document, content: string | Paragraph[]) => Run;
+export declare const endnote: (doc: document_d_exports.Document, content: string | Paragraph[]) => Run;
 type TableOfContentsOptions = {
   /** Heading levels to include, `1 <= from <= to <= 9` (default 1-3). */
   levels?: {
@@ -98,6 +98,6 @@ type TableOfContentsOptions = {
  * table on open. Set `package.settings.updateFields` as well to have Word
  * recompute without prompting for each field.
  */
-declare const createTableOfContentsField: ({ levels, hyperlinks, placeholderText }?: TableOfContentsOptions) => Paragraph;
+export declare const createTableOfContentsField: ({ levels, hyperlinks, placeholderText }?: TableOfContentsOptions) => Paragraph;
 //#endregion
-export { HEADING_LEVELS, HeadingLevel, InvalidFolioReportBuilderOptionsError, TableCellSpec, bookmark, createTableOfContentsField, endnote, heading, hyperlink, pageBreak, paragraph, run, table };
+export {};

package/dist/docx/server/build.js

@@ -1,7 +1,7 @@
 import { mintBookmarkId, reserveBookmarkIds } from "../bookmarkIds.js";
 import { mintEndnoteId } from "../noteIds.js";
 import { TaggedError } from "better-result";
-import { assertValidOoxmlNumericId } from "@stll/docx-core";
+import { assertValidOoxmlNumericId, finalizeParagraphFormatting } from "@stll/docx-core";
 //#region src/docx/server/build.ts
 /**
 * Headless document builders.
@@ -72,11 +72,14 @@ const run = (text, formatting) => ({
 		text
 	}]
 });
-const paragraph = (content, formatting) => ({
-	type: "paragraph",
-	...formatting ? { formatting } : {},
-	content: typeof content === "string" ? [run(content)] : content
-});
+const paragraph = (content, formatting) => {
+	const finalizedFormatting = finalizeParagraphFormatting(formatting);
+	return {
+		type: "paragraph",
+		...finalizedFormatting === void 0 ? {} : { formatting: finalizedFormatting },
+		content: typeof content === "string" ? [run(content)] : content
+	};
+};
 /** A paragraph in the `Heading<level>` style. */
 const heading = ({ text, level }) => {
 	assertHeadingLevel(level);

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 };