@stll/folio-core 0.64.0 → 0.65.0

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

@@ -2,7 +2,6 @@ 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
 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 = {
@@ -77,5 +76,4 @@ export declare class FolioDocxXmlPatchApplicationError extends FolioDocxXmlPatch
 }> {}
 /** Apply a guarded XML proposal and return output only after full profile validation. */
 export declare const applyDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, validationProfile, archive, limits }: ApplyDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchApplication>;
-//#endregion
 export {};

package/dist/docx/server/applyDocxXmlPatchProposal.js

@@ -1,12 +1,10 @@
-import { encodeUtf8 } from "../../utils/textEncoding.js";
 import { loadDocxArchive } from "./boundedArchive.js";
 import { FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, InvalidFolioDocxXmlPatchProposalError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal } from "./evaluateDocxXmlPatchProposal.js";
 import { FOLIO_DOCX_CONFORMANCE_PROFILE, validateDocxConformance } from "./validateDocxConformance.js";
 import { TaggedError, panic } from "better-result";
 import { createHash } from "node:crypto";
-import JSZip from "jszip";
-import { writeZipPart } from "@stll/docx-core/zip";
-//#region src/docx/server/applyDocxXmlPatchProposal.ts
+import { ZipArchive } from "@stll/docx-core/zip";
+// 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";
@@ -60,29 +58,26 @@ const verifyArchiveContents = async (bytes, options) => {
 			cause
 		});
 	}
-	for (const entry of archive.entryMetadata.toSorted(({ path: left }, { path: right }) => left < right ? -1 : Number(left > right))) {
-		if (entry.directory) continue;
-		try {
-			if (await archive.readEntryUint8(entry.path) === null) throw new FolioDocxXmlPatchApplicationError({
-				message: "An archive entry disappeared during verification.",
-				stage: "verify",
-				part: entry.path
-			});
-		} catch (cause) {
-			if (cause instanceof FolioDocxXmlPatchApplicationError) throw cause;
-			throw new FolioDocxXmlPatchApplicationError({
-				message: "An archive entry could not be verified within the configured limits.",
-				stage: "verify",
-				part: entry.path,
-				cause
-			});
-		}
+	for (const entry of archive.entryMetadata.toSorted(({ path: left }, { path: right }) => left < right ? -1 : Number(left > right))) try {
+		if (await archive.readEntryUint8(entry.path) === null) throw new FolioDocxXmlPatchApplicationError({
+			message: "An archive entry disappeared during verification.",
+			stage: "verify",
+			part: entry.path
+		});
+	} catch (cause) {
+		if (cause instanceof FolioDocxXmlPatchApplicationError) throw cause;
+		throw new FolioDocxXmlPatchApplicationError({
+			message: "An archive entry could not be verified within the configured limits.",
+			stage: "verify",
+			part: entry.path,
+			cause
+		});
 	}
 };
 const applyReplacements = async ({ bytes, proposal }) => {
 	let zip;
 	try {
-		zip = await JSZip.loadAsync(bytes);
+		zip = await ZipArchive.read(bytes);
 	} catch (cause) {
 		throw new FolioDocxXmlPatchApplicationError({
 			message: "The evaluated package could not be loaded for replacement.",
@@ -91,31 +86,15 @@ const applyReplacements = async ({ bytes, proposal }) => {
 		});
 	}
 	for (const replacement of proposal.replacements) {
-		const current = zip.file(replacement.path);
-		if (current === null) throw new FolioDocxXmlPatchApplicationError({
+		const current = zip.entry(replacement.path);
+		if (current === void 0) throw new FolioDocxXmlPatchApplicationError({
 			message: "An evaluated package part was unavailable during replacement.",
 			stage: "replace"
 		});
-		writeZipPart({
-			zip,
-			path: replacement.path,
-			data: encodeUtf8(replacement.replacementXml),
-			options: {
-				date: current.date,
-				comment: current.comment,
-				unixPermissions: current.unixPermissions,
-				dosPermissions: current.dosPermissions,
-				compression: "DEFLATE",
-				compressionOptions: { level: 6 }
-			}
-		});
+		zip.set(replacement.path, replacement.replacementXml, { modified: current.modified });
 	}
 	try {
-		return await zip.generateAsync({
-			type: "uint8array",
-			compression: "DEFLATE",
-			compressionOptions: { level: 6 }
-		});
+		return await zip.generate({ level: 6 });
 	} catch (cause) {
 		throw new FolioDocxXmlPatchApplicationError({
 			message: "The replacement package could not be generated.",
@@ -207,5 +186,4 @@ const applyDocxXmlPatchProposal = async ({ bytes, proposal: rawProposal, allowed
 		conformance
 	});
 };
-//#endregion
 export { FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplicationError, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal };

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

@@ -1,6 +1,5 @@
 import { XmlResourceLimits } from "../xmlResourceLimits.js";
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/server/boundedArchive.d.ts
 export declare const DOCX_MAX_ENTRY_BYTES: number;
 export declare const DOCX_MAX_TOTAL_BYTES: number;
 export declare const DOCX_MAX_ENTRIES = 4096;
@@ -38,8 +37,7 @@ export type DocxArchiveOptions = {
 };
 export type DocxArchiveEntry = {
   readonly path: string;
-  readonly directory: boolean;
-  readonly declaredUncompressedBytes: number | null;
+  readonly declaredUncompressedBytes: number;
 };
 export type DocxArchiveReadOptions = {
   maxBytes?: number;
@@ -51,5 +49,4 @@ export type DocxArchive = {
   readEntryUint8: (path: string, options?: DocxArchiveReadOptions) => Promise<Uint8Array | null>;
 };
 export declare const loadDocxArchive: (bytes: ArrayBuffer | Uint8Array, options?: DocxArchiveOptions) => Promise<DocxArchive>;
-//#endregion
 export {};

package/dist/docx/server/boundedArchive.js

@@ -1,9 +1,9 @@
 import { decodeText } from "../../utils/textEncoding.js";
-import { compressionRatioLimitFor, countCentralDirectoryRecords, createInflationBudget, exceedsCompressionRatio, getZipEntrySizes, inflateEntryWithinLimits } from "../archiveInflation.js";
+import { DOCX_COMPRESSION_RATIO_GRACE_BYTES, isRatioBoundedPart } from "../archiveInflation.js";
 import { FOLIO_XML_RESOURCE_LIMITS, assertXmlResourceLimits, createXmlPackageBudget } from "../xmlResourceLimits.js";
-import { TaggedError } from "better-result";
-import JSZip from "jszip";
-//#region src/docx/server/boundedArchive.ts
+import { Result, TaggedError } from "better-result";
+import { ZipArchive, ZipError } from "@stll/docx-core/zip";
+// src/docx/server/boundedArchive.ts
 const DOCX_MAX_ENTRY_BYTES = 134217728;
 const DOCX_MAX_TOTAL_BYTES = 268435456;
 const DOCX_MAX_ENTRIES = 4096;
@@ -11,27 +11,42 @@ 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 DocxArchiveErrorBase {};
-const readLimitError = ({ limit, path, maxEntryBytes, maxTotalBytes, maxCompressionRatio }) => {
-	switch (limit) {
-		case "declared-size": return new DocxArchiveError({
-			message: `DOCX entry "${path}" inflated past its declared size`,
-			reason: "entry-too-large"
+/** The archive error for a read the ZIP reader refused. */
+const archiveErrorFor = (error, { maxEntryBytes, maxTotalBytes, maxEntries, maxCompressionRatio }) => {
+	const entry = error.path === void 0 ? "" : ` "${error.path}"`;
+	switch (error.reason) {
+		case "too-many-entries": return new DocxArchiveError({
+			message: `DOCX archive holds more than ${maxEntries} entries`,
+			reason: "too-many-entries"
 		});
-		case "compression-ratio": return new DocxArchiveError({
-			message: `DOCX entry "${path}" exceeded the ${maxCompressionRatio}:1 compression ratio limit`,
-			reason: "compression-ratio-exceeded"
+		case "entry-too-large": return new DocxArchiveError({
+			message: `DOCX entry${entry} declares more than ${maxEntryBytes} bytes`,
+			reason: "entry-too-large"
 		});
-		case "entry": return new DocxArchiveError({
-			message: `DOCX entry "${path}" exceeded the ${maxEntryBytes}-byte limit`,
+		case "declared-size-exceeded": return new DocxArchiveError({
+			message: `DOCX entry${entry} inflated past its declared size`,
 			reason: "entry-too-large"
 		});
-		case "total":
-		case "aborted": return new DocxArchiveError({
-			message: `DOCX archive exceeded the ${maxTotalBytes}-byte cumulative limit while reading "${path}"`,
+		case "total-too-large": return new DocxArchiveError({
+			message: `DOCX archive declares more than ${maxTotalBytes} cumulative bytes`,
 			reason: "total-too-large"
 		});
+		case "compression-ratio": return new DocxArchiveError({
+			message: error.path === void 0 ? `DOCX archive declares more than ${maxCompressionRatio} bytes per archive byte` : `DOCX entry${entry} declares more than ${maxCompressionRatio} bytes per compressed byte`,
+			reason: "compression-ratio-exceeded"
+		});
+		case "malformed":
+		case "unsupported":
+		case "invalid-entry-name":
+		case "duplicate-entry":
+		case "corrupt-entry": return new DocxArchiveError({
+			message: "Failed to parse DOCX archive",
+			reason: "load-failed",
+			cause: error
+		});
 	}
 };
+const toArchiveError = (cause, limits) => cause instanceof ZipError ? archiveErrorFor(cause, limits) : cause;
 const resolveByteLimit = ({ value, fallback, name }) => {
 	const limit = value ?? fallback;
 	if (!Number.isSafeInteger(limit) || limit < 0) throw new DocxArchiveError({
@@ -40,7 +55,6 @@ const resolveByteLimit = ({ value, fallback, name }) => {
 	});
 	return limit;
 };
-const asBytes = (bytes) => bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
 const loadDocxArchive = async (bytes, options = {}) => {
 	const maxInputBytes = resolveByteLimit({
 		value: options.maxInputBytes,
@@ -71,103 +85,68 @@ const loadDocxArchive = async (bytes, options = {}) => {
 		message: `DOCX input contains ${bytes.byteLength} bytes (max ${maxInputBytes})`,
 		reason: "input-too-large"
 	});
-	if (countCentralDirectoryRecords(asBytes(bytes), maxEntries) > maxEntries) throw new DocxArchiveError({
-		message: `DOCX archive holds more than ${maxEntries} entries`,
-		reason: "too-many-entries"
-	});
-	let zip;
-	try {
-		zip = await JSZip.loadAsync(bytes);
-	} catch (cause) {
-		throw new DocxArchiveError({
-			message: "Failed to parse DOCX archive",
-			reason: "load-failed",
-			cause
-		});
-	}
-	const archiveEntries = Object.values(zip.files);
-	if (archiveEntries.length > maxEntries) throw new DocxArchiveError({
-		message: `DOCX archive declares ${archiveEntries.length} entries (max ${maxEntries})`,
-		reason: "too-many-entries"
-	});
-	let declaredTotalBytes = 0;
-	let declaredTotalKnown = true;
-	for (const entry of archiveEntries) {
-		if (entry.dir) continue;
-		const { compressedBytes, uncompressedBytes } = getZipEntrySizes(entry);
-		if (uncompressedBytes === null) {
-			declaredTotalKnown = false;
-			continue;
-		}
-		if (uncompressedBytes > maxEntryBytes) throw new DocxArchiveError({
-			message: `DOCX entry "${entry.name}" declares ${uncompressedBytes} bytes (max ${maxEntryBytes})`,
-			reason: "entry-too-large"
-		});
-		if (exceedsCompressionRatio({
-			inflatedBytes: uncompressedBytes,
-			compressedBytes,
-			maxRatio: compressionRatioLimitFor(entry.name, maxCompressionRatio)
-		})) throw new DocxArchiveError({
-			message: `DOCX entry "${entry.name}" declares more than ${maxCompressionRatio} bytes per compressed byte`,
-			reason: "compression-ratio-exceeded"
-		});
-		declaredTotalBytes += uncompressedBytes;
-	}
-	if (declaredTotalKnown && declaredTotalBytes > maxTotalBytes) throw new DocxArchiveError({
-		message: `DOCX archive declares ${declaredTotalBytes} cumulative bytes (max ${maxTotalBytes})`,
-		reason: "total-too-large"
-	});
-	if (exceedsCompressionRatio({
-		inflatedBytes: declaredTotalBytes,
-		compressedBytes: bytes.byteLength,
-		maxRatio: maxCompressionRatio
-	})) throw new DocxArchiveError({
-		message: `DOCX archive declares more than ${maxCompressionRatio} bytes per archive byte`,
-		reason: "compression-ratio-exceeded"
+	const limits = {
+		maxEntryBytes,
+		maxTotalBytes,
+		maxEntries,
+		maxCompressionRatio
+	};
+	const read = await Result.tryPromise({
+		try: async () => await ZipArchive.read(bytes, {
+			limits: {
+				maxEntries,
+				maxEntryBytes,
+				maxTotalBytes,
+				maxCompressionRatio,
+				compressionRatioGraceBytes: DOCX_COMPRESSION_RATIO_GRACE_BYTES
+			},
+			isCompressionRatioExempt: (path) => !isRatioBoundedPart(path)
+		}),
+		catch: (cause) => toArchiveError(cause, limits)
 	});
+	if (Result.isError(read)) throw read.error;
+	const zip = read.value;
+	const archiveEntries = zip.entries();
 	const xmlLimits = {
 		...FOLIO_XML_RESOURCE_LIMITS,
 		...options.xmlLimits
 	};
 	const xmlBudget = createXmlPackageBudget();
 	const countedParts = /* @__PURE__ */ new Set();
-	const inflationBudget = createInflationBudget(maxTotalBytes);
-	let readChain = Promise.resolve();
+	let readBytes = 0;
 	const readEntry = async (path, readOptions = {}) => {
 		const requestedMaxBytes = resolveByteLimit({
 			value: readOptions.maxBytes,
 			fallback: maxEntryBytes,
 			name: "DOCX entry read byte limit"
 		});
-		const work = async () => {
-			const entry = zip.file(path);
-			if (!entry) return null;
-			const entryLimit = Math.min(requestedMaxBytes, maxEntryBytes);
-			const result = await inflateEntryWithinLimits({
-				entry,
-				maxEntryBytes: entryLimit,
-				maxCompressionRatio: compressionRatioLimitFor(path, maxCompressionRatio),
-				budget: inflationBudget
-			});
-			if (!result.ok) throw readLimitError({
-				limit: result.limit,
-				path,
-				maxEntryBytes: entryLimit,
-				maxTotalBytes,
-				maxCompressionRatio
-			});
-			return result.bytes;
-		};
-		const next = readChain.then(work, work);
-		readChain = next.then(() => void 0, () => void 0);
-		return await next;
+		const entry = zip.entry(path);
+		if (!entry) return null;
+		const entryLimit = Math.min(requestedMaxBytes, maxEntryBytes);
+		if (entry.size > entryLimit) throw new DocxArchiveError({
+			message: `DOCX entry "${path}" exceeded the ${entryLimit}-byte limit`,
+			reason: "entry-too-large"
+		});
+		if (readBytes + entry.size > maxTotalBytes) throw new DocxArchiveError({
+			message: `DOCX archive exceeded the ${maxTotalBytes}-byte cumulative limit while reading "${path}"`,
+			reason: "total-too-large"
+		});
+		readBytes += entry.size;
+		const content = await Result.tryPromise({
+			try: async () => await entry.bytes(),
+			catch: (cause) => toArchiveError(cause, limits)
+		});
+		if (Result.isError(content)) {
+			readBytes -= entry.size;
+			throw content.error;
+		}
+		return content.value;
 	};
 	return {
-		entries: Object.freeze(archiveEntries.map(({ name }) => name)),
+		entries: Object.freeze(archiveEntries.map(({ path }) => path)),
 		entryMetadata: Object.freeze(archiveEntries.map((entry) => ({
-			path: entry.name,
-			directory: entry.dir,
-			declaredUncompressedBytes: getZipEntrySizes(entry).uncompressedBytes
+			path: entry.path,
+			declaredUncompressedBytes: entry.size
 		}))),
 		async readEntryString(path) {
 			const content = await readEntry(path);
@@ -188,5 +167,4 @@ const loadDocxArchive = async (bytes, options = {}) => {
 		readEntryUint8: readEntry
 	};
 };
-//#endregion
 export { DOCX_MAX_ENTRIES, DOCX_MAX_ENTRY_BYTES, DOCX_MAX_INPUT_BYTES, DOCX_MAX_TOTAL_BYTES, DocxArchiveError, loadDocxArchive };

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

@@ -3,7 +3,6 @@ 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 InvalidFolioReportBuilderOptionsErrorBase: TaggedErrorClass<"InvalidFolioReportBuilderOptionsError">;
 export declare const HEADING_LEVELS: readonly [1, 2, 3, 4, 5, 6];
 export type HeadingLevel = (typeof HEADING_LEVELS)[number];
@@ -100,5 +99,4 @@ type TableOfContentsOptions = {
  * recompute without prompting for each field.
  */
 export declare const createTableOfContentsField: ({ levels, hyperlinks, placeholderText }?: TableOfContentsOptions) => Paragraph;
-//#endregion
 export {};

package/dist/docx/server/build.js

@@ -2,7 +2,7 @@ import { mintBookmarkId, reserveBookmarkIds } from "../bookmarkIds.js";
 import { mintEndnoteId } from "../noteIds.js";
 import { TaggedError } from "better-result";
 import { assertValidOoxmlNumericId, finalizeParagraphFormatting } from "@stll/docx-core";
-//#region src/docx/server/build.ts
+// src/docx/server/build.ts
 /**
 * Headless document builders.
 *
@@ -283,5 +283,4 @@ const createTableOfContentsField = ({ levels = DEFAULT_TOC_LEVELS, hyperlinks =
 		}]
 	};
 };
-//#endregion
 export { HEADING_LEVELS, InvalidFolioReportBuilderOptionsError, bookmark, createTableOfContentsField, endnote, heading, hyperlink, pageBreak, paragraph, run, table };

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

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../../types/document.js";
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/server/createBilingualDocument.d.ts
 export type BilingualRowKind = "paragraph" | "heading" | "listItem";
 /** One translatable unit: a source paragraph and its right-column copy. */
 export type BilingualParagraphRef = {
@@ -81,5 +80,4 @@ export declare function createBilingualDocument(source: document_d_exports.Docum
  * in document order.
  */
 export declare function readBilingualDocument(document: document_d_exports.Document, editableParagraphIds: ReadonlySet<string>): BilingualRow[];
-//#endregion
 export {};

package/dist/docx/server/createBilingualDocument.js

@@ -10,7 +10,7 @@ import { cloneParagraphWithoutPropertySource } from "../paragraphPropertySource.
 import { getRunText } from "../runParser.js";
 import { TaggedError, panic } from "better-result";
 import { finalizeParagraphFormatting } from "@stll/docx-core/model";
-//#region src/docx/server/createBilingualDocument.ts
+// src/docx/server/createBilingualDocument.ts
 /**
 * Bilingual document transform: body -> two-column table, one row per block.
 *
@@ -861,5 +861,4 @@ const isBilingualTable = (table) => {
 	return table.rows.length > 0;
 };
 const isParagraphWithId = (value) => "type" in value && value.type === "paragraph" && "paraId" in value && typeof value.paraId === "string";
-//#endregion
 export { BILINGUAL_TABLE_LAYOUTS, InvalidBilingualDocumentOptionsError, createBilingualDocument, readBilingualDocument };

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

@@ -1,5 +1,4 @@
 import { BilingualRow, CreateBilingualDocumentOptions } from "./createBilingualDocument.js";
-//#region src/docx/server/createBilingualDocx.d.ts
 export type CreateBilingualDocxOptions = Omit<CreateBilingualDocumentOptions, "editableParagraphIds">;
 export type CreateBilingualDocxResult = {
   buffer: ArrayBuffer;
@@ -15,5 +14,4 @@ export type CreateBilingualDocxResult = {
  */
 export declare function createBilingualDocx(input: ArrayBuffer | Uint8Array, options: CreateBilingualDocxOptions): Promise<CreateBilingualDocxResult>;
 /** Bytes-in form of {@link readBilingualDocument}. */
-export declare function readBilingualDocx(input: ArrayBuffer | Uint8Array): Promise<BilingualRow[]>;
-//#endregion
+export declare function readBilingualDocx(input: ArrayBuffer | Uint8Array): Promise<BilingualRow[]>;

package/dist/docx/server/createBilingualDocx.js

@@ -5,7 +5,7 @@ import { ensureParaIds } from "../ensureParaIds.js";
 import { parseDocx } from "../parser.js";
 import { createDocx } from "../rezip.js";
 import { createBilingualDocument, readBilingualDocument } from "./createBilingualDocument.js";
-//#region src/docx/server/createBilingualDocx.ts
+// src/docx/server/createBilingualDocx.ts
 /**
 * Bytes-in / bytes-out form of {@link createBilingualDocument}: stamp every
 * paragraph with a `paraId` (so left-column rows are addressable later), parse
@@ -36,5 +36,4 @@ async function readBilingualDocx(input) {
 	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

@@ -1,5 +1,4 @@
 import { MarkdownOptions } from "../../markdown/types.js";
-//#region src/docx/server/docxToMarkdown.d.ts
 /**
  * Convert a DOCX file to markdown in a single server-safe call.
  *
@@ -9,5 +8,4 @@ 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.
  */
-export declare function docxToMarkdown(input: ArrayBuffer | Uint8Array, opts?: MarkdownOptions): Promise<string>;
-//#endregion
+export declare function docxToMarkdown(input: ArrayBuffer | Uint8Array, opts?: MarkdownOptions): Promise<string>;

package/dist/docx/server/docxToMarkdown.js

@@ -1,6 +1,6 @@
 import { toMarkdown } from "../../markdown/index.js";
 import { parseDocx } from "../parser.js";
-//#region src/docx/server/docxToMarkdown.ts
+// src/docx/server/docxToMarkdown.ts
 /**
 * Convert a DOCX file to markdown in a single server-safe call.
 *
@@ -14,5 +14,4 @@ async function docxToMarkdown(input, opts) {
 	const doc = await parseDocx(input, { preloadFonts: false });
 	return toMarkdown(doc, opts);
 }
-//#endregion
 export { docxToMarkdown };

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

@@ -1,6 +1,5 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/server/evaluateDocxXmlPatchProposal.d.ts
 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<{
@@ -76,5 +75,4 @@ export declare class InvalidFolioDocxXmlPatchProposalOptionsError extends Invali
 }> {}
 export declare const parseFolioDocxXmlPatchProposal: (value: unknown) => FolioDocxXmlPatchProposal;
 export declare const evaluateDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, archive, limits: rawLimits }: EvaluateDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchProposalEvaluation>;
-//#endregion
 export {};

package/dist/docx/server/evaluateDocxXmlPatchProposal.js

@@ -4,7 +4,7 @@ import { DocxArchiveError } from "./boundedArchive.js";
 import { FolioDocxPackageInspectionError, inspectDocxPackage } from "./inspectDocxPackage.js";
 import { TaggedError, panic } from "better-result";
 import { createHash } from "node:crypto";
-//#region src/docx/server/evaluateDocxXmlPatchProposal.ts
+// src/docx/server/evaluateDocxXmlPatchProposal.ts
 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({
@@ -369,5 +369,4 @@ const evaluateDocxXmlPatchProposal = async ({ bytes, proposal: rawProposal, allo
 		limits
 	});
 };
-//#endregion
 export { 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, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal };

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

@@ -1,5 +1,4 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
-//#region src/docx/server/extractDocxText.d.ts
 /** Document part containing an extracted paragraph. */
 export type DocxParagraphSource = "header" | "body" | "footer";
 /**
@@ -66,5 +65,4 @@ export type ExtractDocxTextOptions = {
   readonly archive?: DocxArchiveOptions;
 };
 /** Extract paragraph text and formatting metadata from a DOCX archive. */
-export declare const extractDocxText: (bytes: ArrayBuffer | Uint8Array, options?: ExtractDocxTextOptions) => Promise<ExtractedDocxText>;
-//#endregion
+export declare const extractDocxText: (bytes: ArrayBuffer | Uint8Array, options?: ExtractDocxTextOptions) => Promise<ExtractedDocxText>;

package/dist/docx/server/extractDocxText.js

@@ -2,7 +2,7 @@ import { escapeTableCell } from "../../markdown/escape.js";
 import { RELATIONSHIP_TYPES, parseRelationships } from "../relsParser.js";
 import { findAllDeep, findDeep, getAttribute, getAttributeByNamespaceUri, getLocalName, getNamespaceUri, getTextContent, parseOnOffValue, parseXml } from "../xmlParser.js";
 import { DocxArchiveError, loadDocxArchive } from "./boundedArchive.js";
-//#region src/docx/server/extractDocxText.ts
+// src/docx/server/extractDocxText.ts
 const DOCUMENT_RELS_PATH = "word/_rels/document.xml.rels";
 const ARCHIVE_LIMIT_REASON = "total-too-large";
 const WORDPROCESSINGML_NAMESPACES = /* @__PURE__ */ new Set(["http://schemas.openxmlformats.org/wordprocessingml/2006/main", "http://purl.oclc.org/ooxml/wordprocessingml/main"]);
@@ -553,5 +553,4 @@ const extractDocxText = async (bytes, options = {}) => {
 		view: "accepted"
 	};
 };
-//#endregion
 export { extractDocxText };

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

@@ -1,6 +1,5 @@
 import { DocxArchiveOptions } from "./boundedArchive.js";
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/server/inspectDocxPackage.d.ts
 export declare const FOLIO_DOCX_PACKAGE_INSPECTION_VERSION: 1;
 export declare const FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS: Readonly<{
   readonly maxXmlParts: 16;
@@ -31,7 +30,7 @@ export type FolioDocxPackagePart = {
   readonly path: string;
   readonly kind: FolioDocxPackagePartKind;
   readonly contentType: string | null;
-  readonly declaredUncompressedBytes: number | null;
+  readonly declaredUncompressedBytes: number;
 };
 export type FolioDocxInspectedXmlPart = {
   readonly path: string;
@@ -62,5 +61,4 @@ export declare const readRequestedXmlParts: ({ paths, partsByPath, limits, readE
  * report when an operation requires a validity decision.
  */
 export declare const inspectDocxPackage: (bytes: ArrayBuffer | Uint8Array, options?: InspectDocxPackageOptions) => Promise<FolioDocxPackageInspection>;
-//#endregion
 export {};

package/dist/docx/server/inspectDocxPackage.js

@@ -3,7 +3,7 @@ import { getAttributeAnyPrefix, getLocalName, parseXmlDocument } from "../xmlPar
 import { DocxArchiveError, loadDocxArchive } from "./boundedArchive.js";
 import { Result, TaggedError } from "better-result";
 import { createHash } from "node:crypto";
-//#region src/docx/server/inspectDocxPackage.ts
+// src/docx/server/inspectDocxPackage.ts
 const FOLIO_DOCX_PACKAGE_INSPECTION_VERSION = 1;
 const FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS = Object.freeze({
 	maxXmlParts: 16,
@@ -200,7 +200,7 @@ const inspectDocxPackage = async (bytes, options = {}) => {
 	const archive = await loadDocxArchive(bytes, options.archive);
 	const contentTypesBytes = await archive.readEntryUint8(CONTENT_TYPES_PATH, { maxBytes: CONTENT_TYPES_READ_LIMIT });
 	const declarations = parseContentTypes(contentTypesBytes === null ? null : decodeXml(contentTypesBytes, CONTENT_TYPES_PATH));
-	const parts = archive.entryMetadata.filter(({ directory }) => !directory).map((entry) => toPackagePart(entry, declarations)).toSorted(({ path: left }, { path: right }) => comparePackagePaths(left, right));
+	const parts = archive.entryMetadata.map((entry) => toPackagePart(entry, declarations)).toSorted(({ path: left }, { path: right }) => comparePackagePaths(left, right));
 	const partsByPath = new Map(parts.map((part) => [part.path, part]));
 	validateRequestedParts({
 		requestedPaths,
@@ -219,5 +219,4 @@ const inspectDocxPackage = async (bytes, options = {}) => {
 		limits
 	};
 };
-//#endregion
 export { FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FolioDocxPackageInspectionError, inspectDocxPackage, readRequestedXmlParts };

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

@@ -1,5 +1,4 @@
 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. */
 export declare const FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME = "prosemirror";
@@ -28,5 +27,4 @@ export type MaterializeYjsDocxOptions = {
  * of the browser editor's full save path for the main document story.
  */
 export declare const materializeYjsDocx: ({ sourceDocx, yjsUpdate }: MaterializeYjsDocxOptions) => Promise<ArrayBuffer>;
-//#endregion
 export {};

package/dist/docx/server/materializeYjsDocx.js

@@ -7,7 +7,7 @@ import { repackDocx } from "../rezip.js";
 import { Result, TaggedError } from "better-result";
 import { initProseMirrorDoc } from "y-prosemirror";
 import * as Y from "yjs";
-//#region src/docx/server/materializeYjsDocx.ts
+// 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";
@@ -93,5 +93,4 @@ const materializeYjsDocx = async ({ sourceDocx, yjsUpdate }) => {
 	if (converted.isErr()) throw converted.error;
 	return await repackDocx(converted.value);
 };
-//#endregion
 export { FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_UPDATE_MAX_BYTES, FolioYjsDocxMaterializationError, materializeYjsDocx };

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

@@ -1,6 +1,5 @@
 import { FolioYjsAttrSchemaVersion } from "../../prosemirror/yjsDocumentMetadata.js";
 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. */
 export declare const FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES: readonly ["invalid_update", "unsupported_version", "update_too_large"];
@@ -51,5 +50,4 @@ export type FolioYjsSnapshotMigrationResult = {
  * not clear it.
  */
 export declare const migrateFolioYjsSnapshot: (update: Uint8Array) => Result<FolioYjsSnapshotMigrationResult, FolioYjsSnapshotMigrationError>;
-//#endregion
 export {};