@stll/folio-core 0.62.0 → 0.63.1

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,30 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
+import { TaggedErrorClass } from "better-result";
 //#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 +32,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 +46,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";
@@ -62,18 +63,18 @@ type FolioDocxXmlPatchProposalEvaluation = {
   readonly replacements: readonly [];
   readonly limits: Required<FolioDocxXmlPatchProposalLimits>;
 };
-declare const InvalidFolioDocxXmlPatchProposalError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocxXmlPatchProposalError">;
-declare class InvalidFolioDocxXmlPatchProposalError extends InvalidFolioDocxXmlPatchProposalError_base<{
+declare const InvalidFolioDocxXmlPatchProposalErrorBase: TaggedErrorClass<"InvalidFolioDocxXmlPatchProposalError">;
+export declare class InvalidFolioDocxXmlPatchProposalError extends InvalidFolioDocxXmlPatchProposalErrorBase<{
   message: string;
   path: string;
   reason: string;
 }> {}
-declare const InvalidFolioDocxXmlPatchProposalOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocxXmlPatchProposalOptionsError">;
-declare class InvalidFolioDocxXmlPatchProposalOptionsError extends InvalidFolioDocxXmlPatchProposalOptionsError_base<{
+declare const InvalidFolioDocxXmlPatchProposalOptionsErrorBase: TaggedErrorClass<"InvalidFolioDocxXmlPatchProposalOptionsError">;
+export declare class InvalidFolioDocxXmlPatchProposalOptionsError extends InvalidFolioDocxXmlPatchProposalOptionsErrorBase<{
   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",
@@ -44,8 +44,10 @@ const XML_SAFETY_ISSUE = {
 		message: "Replacement XML must be well formed."
 	}
 };
-var InvalidFolioDocxXmlPatchProposalError = class extends TaggedError("InvalidFolioDocxXmlPatchProposalError") {};
-var InvalidFolioDocxXmlPatchProposalOptionsError = class extends TaggedError("InvalidFolioDocxXmlPatchProposalOptionsError") {};
+const InvalidFolioDocxXmlPatchProposalErrorBase = TaggedError("InvalidFolioDocxXmlPatchProposalError");
+var InvalidFolioDocxXmlPatchProposalError = class extends InvalidFolioDocxXmlPatchProposalErrorBase {};
+const InvalidFolioDocxXmlPatchProposalOptionsErrorBase = TaggedError("InvalidFolioDocxXmlPatchProposalOptionsError");
+var InvalidFolioDocxXmlPatchProposalOptionsError = class extends InvalidFolioDocxXmlPatchProposalOptionsErrorBase {};
 const SHA256_PATTERN = /^[\da-f]{64}$/u;
 const XML_DECLARED_ENCODING_PATTERN = /^\uFEFF?<\?xml[^>]*\bencoding\s*=\s*["']([^"']+)["'][^>]*\?>/iu;
 const MAX_PACKAGE_PATH_CODE_UNITS = 1024;

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,39 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
+import { TaggedErrorClass } from "better-result";
 //#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];
-declare const FolioDocxPackageInspectionError_base: import("better-result").TaggedErrorClass<"FolioDocxPackageInspectionError">;
-declare class FolioDocxPackageInspectionError extends FolioDocxPackageInspectionError_base<{
+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 FolioDocxPackageInspectionErrorBase: TaggedErrorClass<"FolioDocxPackageInspectionError">;
+export declare class FolioDocxPackageInspectionError extends FolioDocxPackageInspectionErrorBase<{
   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 +41,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 +55,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",
@@ -20,9 +20,10 @@ const FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES = Object.freeze([
 	"xml-total-too-large",
 	"xml-decode-failed"
 ]);
-var FolioDocxPackageInspectionError = class extends TaggedError("FolioDocxPackageInspectionError") {};
+const FolioDocxPackageInspectionErrorBase = TaggedError("FolioDocxPackageInspectionError");
+var FolioDocxPackageInspectionError = class extends FolioDocxPackageInspectionErrorBase {};
 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) => {

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

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

package/dist/docx/server/materializeYjsDocx.js

@@ -8,10 +8,11 @@ import { Result, TaggedError } from "better-result";
 import { initProseMirrorDoc } from "y-prosemirror";
 import * as Y from "yjs";
 //#region src/docx/server/materializeYjsDocx.ts
+const FolioYjsDocxMaterializationErrorBase = TaggedError("FolioYjsDocxMaterializationError");
 /** Yjs fragment that stores Folio's canonical ProseMirror document. */
 const FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME = "prosemirror";
 /** Maximum accepted size of a complete Yjs collaboration state update. */
-const FOLIO_YJS_UPDATE_MAX_BYTES = 10 * 1024 * 1024;
+const FOLIO_YJS_UPDATE_MAX_BYTES = 10485760;
 /** Stable failure codes returned by server-side Yjs-to-DOCX materialization. */
 const FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES = [
 	"empty_update",
@@ -22,7 +23,7 @@ const FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES = [
 	"update_too_large"
 ];
 /** Typed failure raised when a collaboration snapshot cannot be materialized. */
-var FolioYjsDocxMaterializationError = class extends TaggedError("FolioYjsDocxMaterializationError") {};
+var FolioYjsDocxMaterializationError = class extends FolioYjsDocxMaterializationErrorBase {};
 const readProseMirrorDocument = (yjsUpdate) => {
 	if (yjsUpdate.byteLength === 0) throw new FolioYjsDocxMaterializationError({
 		code: "empty_update",

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

@@ -1,19 +1,19 @@
 import { FolioYjsAttrSchemaVersion } from "../../prosemirror/yjsDocumentMetadata.js";
-import { Result } from "better-result";
+import { Result, TaggedErrorClass } from "better-result";
 //#region src/docx/server/migrateYjsAttrSchema.d.ts
+declare const FolioYjsSnapshotMigrationErrorBase: TaggedErrorClass<"FolioYjsSnapshotMigrationError">;
 /** Stable failure codes returned by an offline snapshot migration. */
-declare const FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES: readonly ["invalid_update", "unsupported_version", "update_too_large"];
+export declare const FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES: readonly ["invalid_update", "unsupported_version", "update_too_large"];
 /** Failure code for a snapshot that could not be migrated. */
-type FolioYjsSnapshotMigrationErrorCode = (typeof FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES)[number];
-declare const FolioYjsSnapshotMigrationError_base: import("better-result").TaggedErrorClass<"FolioYjsSnapshotMigrationError">;
+export type FolioYjsSnapshotMigrationErrorCode = (typeof FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES)[number];
 /** Typed failure raised when a collaboration snapshot cannot be migrated. */
-declare class FolioYjsSnapshotMigrationError extends FolioYjsSnapshotMigrationError_base<{
+export declare class FolioYjsSnapshotMigrationError extends FolioYjsSnapshotMigrationErrorBase<{
   code: FolioYjsSnapshotMigrationErrorCode;
   message: string;
   cause?: unknown;
 }> {}
 /** What an offline migration did to one snapshot. */
-type FolioYjsSnapshotMigrationResult = {
+export type FolioYjsSnapshotMigrationResult = {
   /** The complete state update to store in place of the input. */
   update: Uint8Array;
   /** The attr-schema version the input was written under. */
@@ -50,6 +50,6 @@ type FolioYjsSnapshotMigrationResult = {
  * Rebind the recorded source in the same statement that clears the seed, or do
  * not clear it.
  */
-declare const migrateFolioYjsSnapshot: (update: Uint8Array) => Result<FolioYjsSnapshotMigrationResult, FolioYjsSnapshotMigrationError>;
+export declare const migrateFolioYjsSnapshot: (update: Uint8Array) => Result<FolioYjsSnapshotMigrationResult, FolioYjsSnapshotMigrationError>;
 //#endregion
-export { FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES, FolioYjsSnapshotMigrationError, FolioYjsSnapshotMigrationErrorCode, FolioYjsSnapshotMigrationResult, migrateFolioYjsSnapshot };
+export {};

package/dist/docx/server/migrateYjsAttrSchema.js

@@ -3,6 +3,7 @@ import { FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME } from "./materializeYjsDocx.js";
 import { Result, TaggedError } from "better-result";
 import * as Y from "yjs";
 //#region src/docx/server/migrateYjsAttrSchema.ts
+const FolioYjsSnapshotMigrationErrorBase = TaggedError("FolioYjsSnapshotMigrationError");
 /** Stable failure codes returned by an offline snapshot migration. */
 const FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES = [
 	"invalid_update",
@@ -10,7 +11,7 @@ const FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES = [
 	"update_too_large"
 ];
 /** Typed failure raised when a collaboration snapshot cannot be migrated. */
-var FolioYjsSnapshotMigrationError = class extends TaggedError("FolioYjsSnapshotMigrationError") {};
+var FolioYjsSnapshotMigrationError = class extends FolioYjsSnapshotMigrationErrorBase {};
 /**
 * Carry a stored collaboration snapshot forward to the attr schema this build
 * writes, without a ProseMirror schema and without rebuilding a single node.
@@ -84,12 +85,12 @@ const migrateFolioYjsSnapshot = (update) => {
 		ydoc.destroy();
 		return Result.err(migratedAttrs.error);
 	}
-	if (fromVersion === 13) {
+	if (fromVersion === 14) {
 		ydoc.destroy();
 		return Result.ok({
 			fromVersion,
 			paragraphsRewritten: 0,
-			toVersion: 13,
+			toVersion: 14,
 			update
 		});
 	}
@@ -99,7 +100,7 @@ const migrateFolioYjsSnapshot = (update) => {
 	return Result.ok({
 		fromVersion,
 		paragraphsRewritten,
-		toVersion: 13,
+		toVersion: 14,
 		update: migrated
 	});
 };

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

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

package/dist/docx/settingsHeaderFooterUpdate.d.ts

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

package/dist/docx/settingsParser.d.ts

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

package/dist/docx/settingsParser.js

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

package/dist/docx/shadingParser.d.ts

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