@stll/folio-core 0.62.0 → 0.63.1

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

@@ -18,7 +18,7 @@ type OwnedRunPropertyChild = readonly [name: DeclaredChild<"run-properties">, xm
 /**
  * Serialize shading properties (w:shd)
  */
-declare function serializeShading(shading: ExhaustiveShadingProperties | undefined): string;
+export declare function serializeShading(shading: ExhaustiveShadingProperties | undefined): string;
 /**
  * The single `w:rPr` writer.
  *
@@ -35,6 +35,6 @@ declare function serializeShading(shading: ExhaustiveShadingProperties | undefin
  *
  * @param owned children a sibling record holds; see {@link OwnedRunPropertyChild}
  */
-declare function serializeTextFormatting(input: ExhaustiveTextFormatting | undefined, owned?: readonly OwnedRunPropertyChild[]): string;
+export declare function serializeTextFormatting(input: ExhaustiveTextFormatting | undefined, owned?: readonly OwnedRunPropertyChild[]): string;
 //#endregion
-export { serializeShading, serializeTextFormatting };
+export {};

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

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/themeSerializer.d.ts
-declare const serializeThemeXml: (theme: document_d_exports.Theme) => string;
-//#endregion
-export { serializeThemeXml };
+export declare const serializeThemeXml: (theme: document_d_exports.Theme) => string;
+//#endregion

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

@@ -2,8 +2,8 @@ import { document_d_exports } from "../../types/document.js";
 //#region src/docx/serializer/trackedChangeAttributes.d.ts
 type SerializableTrackedChangeInfo = document_d_exports.TrackedChangeInfo | document_d_exports.PropertyChangeInfo;
 /** Normalized, unescaped attributes in schema order for an XML element or string serializer. */
-declare const trackedChangeAttributeEntries: (info: SerializableTrackedChangeInfo) => readonly (readonly [string, string])[];
-declare const trackedChangeAttributeRecord: (info: SerializableTrackedChangeInfo) => Record<string, string>;
-declare const serializeTrackedChangeAttributes: (info: SerializableTrackedChangeInfo) => string;
+export declare const trackedChangeAttributeEntries: (info: SerializableTrackedChangeInfo) => readonly (readonly [string, string])[];
+export declare const trackedChangeAttributeRecord: (info: SerializableTrackedChangeInfo) => Record<string, string>;
+export declare const serializeTrackedChangeAttributes: (info: SerializableTrackedChangeInfo) => string;
 //#endregion
-export { serializeTrackedChangeAttributes, trackedChangeAttributeEntries, trackedChangeAttributeRecord };
+export {};

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

@@ -1,10 +1,11 @@
 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";
+import { TaggedErrorClass } from "better-result";
 //#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 +14,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 +29,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";
@@ -62,19 +63,19 @@ type FolioDocxXmlPatchApplication = {
   readonly receipt: FolioDocxXmlPatchApplicationReceipt;
   readonly bytes: Uint8Array;
 };
-declare const UnsupportedFolioDocxXmlPatchApplicationProfileError_base: import("better-result").TaggedErrorClass<"UnsupportedFolioDocxXmlPatchApplicationProfileError">;
-declare class UnsupportedFolioDocxXmlPatchApplicationProfileError extends UnsupportedFolioDocxXmlPatchApplicationProfileError_base<{
+declare const UnsupportedFolioDocxXmlPatchApplicationProfileErrorBase: TaggedErrorClass<"UnsupportedFolioDocxXmlPatchApplicationProfileError">;
+export declare class UnsupportedFolioDocxXmlPatchApplicationProfileError extends UnsupportedFolioDocxXmlPatchApplicationProfileErrorBase<{
   message: string;
   profile: unknown;
 }> {}
-declare const FolioDocxXmlPatchApplicationError_base: import("better-result").TaggedErrorClass<"FolioDocxXmlPatchApplicationError">;
-declare class FolioDocxXmlPatchApplicationError extends FolioDocxXmlPatchApplicationError_base<{
+declare const FolioDocxXmlPatchApplicationErrorBase: TaggedErrorClass<"FolioDocxXmlPatchApplicationError">;
+export declare class FolioDocxXmlPatchApplicationError extends FolioDocxXmlPatchApplicationErrorBase<{
   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,14 +4,16 @@ 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";
 const isConformantReport = (report) => report.status === "conformant";
-var UnsupportedFolioDocxXmlPatchApplicationProfileError = class extends TaggedError("UnsupportedFolioDocxXmlPatchApplicationProfileError") {};
-var FolioDocxXmlPatchApplicationError = class extends TaggedError("FolioDocxXmlPatchApplicationError") {};
+const UnsupportedFolioDocxXmlPatchApplicationProfileErrorBase = TaggedError("UnsupportedFolioDocxXmlPatchApplicationProfileError");
+var UnsupportedFolioDocxXmlPatchApplicationProfileError = class extends UnsupportedFolioDocxXmlPatchApplicationProfileErrorBase {};
+const FolioDocxXmlPatchApplicationErrorBase = TaggedError("FolioDocxXmlPatchApplicationError");
+var FolioDocxXmlPatchApplicationError = class extends FolioDocxXmlPatchApplicationErrorBase {};
 const sha256 = (bytes) => createHash("sha256").update(bytes).digest("hex");
 const snapshotInput = (bytes) => Uint8Array.from(bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes));
 const snapshotArchiveOptions = (archive) => {

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

@@ -1,17 +1,18 @@
 import { XmlResourceLimits } from "../xmlResourceLimits.js";
+import { TaggedErrorClass } from "better-result";
 //#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;
-declare const DocxArchiveError_base: import("better-result").TaggedErrorClass<"DocxArchiveError">;
+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 DocxArchiveErrorBase: 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 DocxArchiveErrorBase<{
   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 +36,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,12 +4,13 @@ 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;
+const DocxArchiveErrorBase = TaggedError("DocxArchiveError");
 /** Error raised when a DOCX archive cannot be loaded within configured limits. */
-var DocxArchiveError = class extends TaggedError("DocxArchiveError") {};
+var DocxArchiveError = class extends DocxArchiveErrorBase {};
 const readLimitError = ({ limit, path, maxEntryBytes, maxTotalBytes, maxCompressionRatio }) => {
 	switch (limit) {
 		case "declared-size": return new DocxArchiveError({

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

@@ -2,29 +2,30 @@ import { ShadingProperties } from "../../types/colors.js";
 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";
+import { TaggedErrorClass } from "better-result";
 //#region src/docx/server/build.d.ts
-declare const HEADING_LEVELS: readonly [1, 2, 3, 4, 5, 6];
-type HeadingLevel = (typeof HEADING_LEVELS)[number];
-declare const InvalidFolioReportBuilderOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioReportBuilderOptionsError">;
+declare const InvalidFolioReportBuilderOptionsErrorBase: TaggedErrorClass<"InvalidFolioReportBuilderOptionsError">;
+export declare const HEADING_LEVELS: readonly [1, 2, 3, 4, 5, 6];
+export type HeadingLevel = (typeof HEADING_LEVELS)[number];
 /**
  * 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 InvalidFolioReportBuilderOptionsErrorBase<{
   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 +42,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 +54,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 +76,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 +99,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.
@@ -11,6 +11,7 @@ import { assertValidOoxmlNumericId } from "@stll/docx-core";
 * without hand-writing model literals. They build model values only; the
 * serializer owns the OOXML.
 */
+const InvalidFolioReportBuilderOptionsErrorBase = TaggedError("InvalidFolioReportBuilderOptionsError");
 /** Character style applied to hyperlink text; present in the bundled style sets. */
 const HYPERLINK_STYLE_ID = "Hyperlink";
 /** Character style applied to the endnote reference mark. */
@@ -44,7 +45,7 @@ const TOC_LEVEL_MAX = 9;
 * a negative column width, a reversed TOC range). Thrown at the boundary so
 * the invalid value never reaches the serializer.
 */
-var InvalidFolioReportBuilderOptionsError = class extends TaggedError("InvalidFolioReportBuilderOptionsError") {};
+var InvalidFolioReportBuilderOptionsError = class extends InvalidFolioReportBuilderOptionsErrorBase {};
 const assertPositiveInteger = (value, path) => {
 	if (!Number.isInteger(value) || value < 1) throw new InvalidFolioReportBuilderOptionsError({
 		message: `${path} must be a positive integer, got ${String(value)}`,
@@ -72,11 +73,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,9 @@
 import { document_d_exports } from "../../types/document.js";
+import { TaggedErrorClass } from "better-result";
 //#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 +11,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 +32,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 +61,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<{
+declare const InvalidBilingualDocumentOptionsErrorBase: TaggedErrorClass<"InvalidBilingualDocumentOptionsError">;
+export declare class InvalidBilingualDocumentOptionsError extends InvalidBilingualDocumentOptionsErrorBase<{
   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 +80,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.
@@ -32,8 +35,10 @@ import { TaggedError, panic } from "better-result";
 const BILINGUAL_TABLE_LAYOUTS = ["inline", "stacked"];
 const STYLE_SUFFIX_PATTERN = /^[A-Za-z0-9-]+$/u;
 const DEFAULT_TABLE_LAYOUT = BILINGUAL_TABLE_LAYOUTS[0];
-var InvalidBilingualDocumentOptionsError = class extends TaggedError("InvalidBilingualDocumentOptionsError") {};
-var UneditableBilingualManifestError = class extends TaggedError("UneditableBilingualManifestError") {};
+const InvalidBilingualDocumentOptionsErrorBase = TaggedError("InvalidBilingualDocumentOptionsError");
+var InvalidBilingualDocumentOptionsError = class extends InvalidBilingualDocumentOptionsErrorBase {};
+const UneditableBilingualManifestErrorBase = TaggedError("UneditableBilingualManifestError");
+var UneditableBilingualManifestError = class extends UneditableBilingualManifestErrorBase {};
 const FULL_WIDTH_PCT = 5e3;
 const HALF_WIDTH_PCT = 2500;
 const A4_TEXT_WIDTH_TWIPS = 9072;
@@ -79,6 +84,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 +134,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 +195,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 +205,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 +241,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 +286,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 +309,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 +348,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 +402,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 +413,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 +433,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 +444,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 +606,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 +616,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 +758,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 +833,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,