@stll/folio-core 0.22.1 → 0.22.3

package/dist/ai-edits/headless.d.ts

@@ -71,16 +71,16 @@ type FolioReviewedStory = {
   text: string;
   changes: FolioReviewChange[];
 };
-declare const UnsupportedFolioReviewedViewError_base: import("better-result").TaggedErrorClass<"UnsupportedFolioReviewedViewError", {
+declare const UnsupportedFolioReviewedViewError_base: import("better-result").TaggedErrorClass<"UnsupportedFolioReviewedViewError">;
+declare class UnsupportedFolioReviewedViewError extends UnsupportedFolioReviewedViewError_base<{
   message: string;
   receivedView: unknown;
-}>;
-declare class UnsupportedFolioReviewedViewError extends UnsupportedFolioReviewedViewError_base {}
-declare const FolioDocumentStoryNotFoundError_base: import("better-result").TaggedErrorClass<"FolioDocumentStoryNotFoundError", {
+}> {}
+declare const FolioDocumentStoryNotFoundError_base: import("better-result").TaggedErrorClass<"FolioDocumentStoryNotFoundError">;
+declare class FolioDocumentStoryNotFoundError extends FolioDocumentStoryNotFoundError_base<{
   message: string;
   story: FolioEditableDocumentStoryHandle;
-}>;
-declare class FolioDocumentStoryNotFoundError extends FolioDocumentStoryNotFoundError_base {}
+}> {}
 type FolioApplyDocumentOperationsToStoryOptions = FolioApplyDocumentOperationsOptions & {
   story: FolioEditableDocumentStoryHandle;
   batch: FolioDocumentOperationBatch;

package/dist/ai-edits/headless.js

@@ -131,8 +131,8 @@ const FOLIO_REVIEWED_VIEWS = Object.freeze([
 	"final"
 ]);
 const FOLIO_RESOLVED_REVIEWED_VIEWS = Object.freeze(["original", "final"]);
-var UnsupportedFolioReviewedViewError = class extends TaggedError("UnsupportedFolioReviewedViewError")() {};
-var FolioDocumentStoryNotFoundError = class extends TaggedError("FolioDocumentStoryNotFoundError")() {};
+var UnsupportedFolioReviewedViewError = class extends TaggedError("UnsupportedFolioReviewedViewError") {};
+var FolioDocumentStoryNotFoundError = class extends TaggedError("FolioDocumentStoryNotFoundError") {};
 const MAIN_STORY = Object.freeze({ type: "main" });
 const headerFooterStoryKey = ({ type, relationshipId }) => `${type}:${relationshipId}`;
 const noteStoryKey = ({ type, noteId }) => `${type}:${noteId}`;

package/dist/content-controls/errors.d.ts

@@ -1,24 +1,18 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/content-controls/errors.d.ts
-declare const ContentControlLockedError_base: import("better-result").TaggedErrorClass<"ContentControlLockedError", {
-  message: string;
-  lock: NonNullable<document_d_exports.SdtProperties["lock"]>;
-  tag?: string;
-  alias?: string;
-}>;
+declare const ContentControlLockedError_base: import("better-result").TaggedErrorClass<"ContentControlLockedError">;
 /**
  * Refused because the target control's `w:lock` forbids the requested
  * mutation. Caller can override with `{ force: true }` if they understand
  * the consequences (overrides apply per call, not per document).
  */
-declare class ContentControlLockedError extends ContentControlLockedError_base {}
-declare const ContentControlBoundError_base: import("better-result").TaggedErrorClass<"ContentControlBoundError", {
+declare class ContentControlLockedError extends ContentControlLockedError_base<{
   message: string;
-  xpath: string;
-  storeItemID?: string;
+  lock: NonNullable<document_d_exports.SdtProperties["lock"]>;
   tag?: string;
   alias?: string;
-}>;
+}> {}
+declare const ContentControlBoundError_base: import("better-result").TaggedErrorClass<"ContentControlBoundError">;
 /**
  * Refused because the target control is bound to a `<w:dataBinding>`.
  *
@@ -33,19 +27,25 @@ declare const ContentControlBoundError_base: import("better-result").TaggedError
  * Reference: python-docx #965, Aspose forum thread on removing custom
  * XML mapping before content updates.
  */
-declare class ContentControlBoundError extends ContentControlBoundError_base {}
-declare const ContentControlTypeError_base: import("better-result").TaggedErrorClass<"ContentControlTypeError", {
+declare class ContentControlBoundError extends ContentControlBoundError_base<{
   message: string;
-  sdtType: document_d_exports.SdtProperties["sdtType"];
-  reason: string;
+  xpath: string;
+  storeItemID?: string;
   tag?: string;
   alias?: string;
-}>;
+}> {}
+declare const ContentControlTypeError_base: import("better-result").TaggedErrorClass<"ContentControlTypeError">;
 /**
  * Refused because the requested operation does not make sense for the
  * control's type — e.g. setting free text on a checkbox, or unwrapping a
  * `w15:repeatingSection` (which would orphan its row items).
  */
-declare class ContentControlTypeError extends ContentControlTypeError_base {}
+declare class ContentControlTypeError extends ContentControlTypeError_base<{
+  message: string;
+  sdtType: document_d_exports.SdtProperties["sdtType"];
+  reason: string;
+  tag?: string;
+  alias?: string;
+}> {}
 //#endregion
 export { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError };

package/dist/content-controls/errors.js

@@ -10,7 +10,7 @@ import { TaggedError } from "better-result";
 * mutation. Caller can override with `{ force: true }` if they understand
 * the consequences (overrides apply per call, not per document).
 */
-var ContentControlLockedError = class extends TaggedError("ContentControlLockedError")() {};
+var ContentControlLockedError = class extends TaggedError("ContentControlLockedError") {};
 /**
 * Refused because the target control is bound to a `<w:dataBinding>`.
 *
@@ -25,12 +25,12 @@ var ContentControlLockedError = class extends TaggedError("ContentControlLockedE
 * Reference: python-docx #965, Aspose forum thread on removing custom
 * XML mapping before content updates.
 */
-var ContentControlBoundError = class extends TaggedError("ContentControlBoundError")() {};
+var ContentControlBoundError = class extends TaggedError("ContentControlBoundError") {};
 /**
 * Refused because the requested operation does not make sense for the
 * control's type — e.g. setting free text on a checkbox, or unwrapping a
 * `w15:repeatingSection` (which would orphan its row items).
 */
-var ContentControlTypeError = class extends TaggedError("ContentControlTypeError")() {};
+var ContentControlTypeError = class extends TaggedError("ContentControlTypeError") {};
 //#endregion
 export { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError };

package/dist/controller/layoutPipeline.js

@@ -58,6 +58,29 @@ function bodyBlocksClearSectionHeaderFooter(blocks, { authoredMargins, sectionHe
 	});
 	return changed ? nextBlocks : blocks;
 }
+const arePageMarginsEqual = (left, right) => left.top === right.top && left.right === right.right && left.bottom === right.bottom && left.left === right.left && left.header === right.header && left.footer === right.footer;
+const mirrorPageMarginsIfNeeded = (authoredMargins, pageNumber, mirrorMargins) => mirrorMargins && pageNumber % 2 === 0 ? {
+	...authoredMargins,
+	left: authoredMargins.right,
+	right: authoredMargins.left
+} : authoredMargins;
+function attachAuthoredMarginsToLayoutPages(layout, options) {
+	let changed = false;
+	const pages = layout.pages.map((page) => {
+		const sectionProperties = options.sectionPropertiesForMargins[page.sectionIndex ?? 0];
+		const authoredMargins = mirrorPageMarginsIfNeeded(sectionProperties ? getMargins(sectionProperties) : options.authoredMargins, page.number, options.mirrorMargins);
+		if (page.authoredMargins && arePageMarginsEqual(page.authoredMargins, authoredMargins)) return page;
+		changed = true;
+		return {
+			...page,
+			authoredMargins
+		};
+	});
+	return changed ? {
+		...layout,
+		pages
+	} : layout;
+}
 function runLayoutPipeline(deps, state, options = {}) {
 	const { contentWidth, columns, pageSize, margins, pageGap, showMarginGuides, marginGuideColor, syncCoordinator, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, sectionHeaderFooterRefs, theme: _theme, sectionProperties, document, defaultTabStop, mirrorMargins, styles, layout, hfPMs, painter, pagesContainer, session, renderHfFromContentOrPm, renderHeaderFooterContentByRId, documentFontsAreLoaded, buildFootnoteRenderItems, describeInvalidHighlightMarks, emptyTemplatePreviewEntries: EMPTY_TEMPLATE_PREVIEW_ENTRIES } = deps;
 	let outcome = {};
@@ -341,6 +364,11 @@ function runLayoutPipeline(deps, state, options = {}) {
 		};
 		let stabilizedFieldValues;
 		stabilizeFieldWidths();
+		newLayout = attachAuthoredMarginsToLayoutPages(newLayout, {
+			authoredMargins: margins,
+			mirrorMargins,
+			sectionPropertiesForMargins
+		});
 		const rebuildHeaderFooterForLayout = () => {
 			const seqValues = buildSeqValues(newBlocks);
 			const bookmarkTextInputs = stabilizedFieldValues === void 0 ? { seqValues } : {

package/dist/document-operations.d.ts

@@ -42,17 +42,17 @@ type FolioDocumentOperationCapabilities = {
 declare const getFolioDocumentOperationCapabilities: () => FolioDocumentOperationCapabilities;
 declare const isFolioDocumentOperationModeSupported: (operationType: FolioDocumentOperationType, mode: FolioDocumentOperationMode) => boolean;
 declare const isSupportedFolioDocumentOperationVersion: (value: unknown) => value is typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
-declare const UnsupportedFolioDocumentOperationVersionError_base: import("better-result").TaggedErrorClass<"UnsupportedFolioDocumentOperationVersionError", {
+declare const UnsupportedFolioDocumentOperationVersionError_base: import("better-result").TaggedErrorClass<"UnsupportedFolioDocumentOperationVersionError">;
+declare class UnsupportedFolioDocumentOperationVersionError extends UnsupportedFolioDocumentOperationVersionError_base<{
   message: string;
   receivedVersion: unknown;
-}>;
-declare class UnsupportedFolioDocumentOperationVersionError extends UnsupportedFolioDocumentOperationVersionError_base {}
-declare const InvalidFolioDocumentOperationBatchError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocumentOperationBatchError", {
+}> {}
+declare const InvalidFolioDocumentOperationBatchError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocumentOperationBatchError">;
+declare class InvalidFolioDocumentOperationBatchError extends InvalidFolioDocumentOperationBatchError_base<{
   message: string;
   path: string;
   reason: string;
-}>;
-declare class InvalidFolioDocumentOperationBatchError extends InvalidFolioDocumentOperationBatchError_base {}
+}> {}
 declare const assertSupportedFolioDocumentOperationVersion: (value: unknown) => typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
 type FolioDocumentOperationBatch = {
   readonly version: typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;

package/dist/document-operations.js

@@ -73,8 +73,8 @@ const isFolioDocumentOperationModeSupported = (operationType, mode) => {
 	return includesDocumentOperationMode(supportedModes, mode);
 };
 const isSupportedFolioDocumentOperationVersion = (value) => value === 1;
-var UnsupportedFolioDocumentOperationVersionError = class extends TaggedError("UnsupportedFolioDocumentOperationVersionError")() {};
-var InvalidFolioDocumentOperationBatchError = class extends TaggedError("InvalidFolioDocumentOperationBatchError")() {};
+var UnsupportedFolioDocumentOperationVersionError = class extends TaggedError("UnsupportedFolioDocumentOperationVersionError") {};
+var InvalidFolioDocumentOperationBatchError = class extends TaggedError("InvalidFolioDocumentOperationBatchError") {};
 const assertSupportedFolioDocumentOperationVersion = (value) => {
 	if (isSupportedFolioDocumentOperationVersion(value)) return value;
 	throw new UnsupportedFolioDocumentOperationVersionError({

package/dist/docx/encryption/errors.d.ts

@@ -7,12 +7,12 @@ declare const DOCX_ENCRYPTION_ERROR_CODES: {
   readonly DECRYPTION_FAILED: "DOCX_DECRYPTION_FAILED";
 };
 type DocxEncryptionErrorCode = (typeof DOCX_ENCRYPTION_ERROR_CODES)[keyof typeof DOCX_ENCRYPTION_ERROR_CODES];
-declare const DocxEncryptionError_base: import("better-result").TaggedErrorClass<"DocxEncryptionError", {
+declare const DocxEncryptionError_base: import("better-result").TaggedErrorClass<"DocxEncryptionError">;
+declare class DocxEncryptionError extends DocxEncryptionError_base<{
   message: string;
   code: DocxEncryptionErrorCode;
   cause?: unknown;
-}>;
-declare class DocxEncryptionError extends DocxEncryptionError_base {}
+}> {}
 declare const isDocxEncryptionError: (error: unknown) => error is DocxEncryptionError;
 //#endregion
 export { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError, DocxEncryptionErrorCode, isDocxEncryptionError };

package/dist/docx/encryption/errors.js

@@ -7,7 +7,7 @@ const DOCX_ENCRYPTION_ERROR_CODES = {
 	ENCRYPTION_UNSUPPORTED: "DOCX_ENCRYPTION_UNSUPPORTED",
 	DECRYPTION_FAILED: "DOCX_DECRYPTION_FAILED"
 };
-var DocxEncryptionError = class extends TaggedError("DocxEncryptionError")() {};
+var DocxEncryptionError = class extends TaggedError("DocxEncryptionError") {};
 const isDocxEncryptionError = (error) => error instanceof DocxEncryptionError;
 //#endregion
 export { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError, isDocxEncryptionError };

package/dist/docx/ensureParaIds.d.ts

@@ -1,10 +1,10 @@
 //#region src/docx/ensureParaIds.d.ts
-declare const EnsureParaIdsError_base: import("better-result").TaggedErrorClass<"EnsureParaIdsError", {
+declare const EnsureParaIdsError_base: import("better-result").TaggedErrorClass<"EnsureParaIdsError">;
+/** A malformed or unsupported package prevented paragraph-ID normalization. */
+declare class EnsureParaIdsError extends EnsureParaIdsError_base<{
   message: string;
   cause?: unknown;
-}>;
-/** A malformed or unsupported package prevented paragraph-ID normalization. */
-declare class EnsureParaIdsError extends EnsureParaIdsError_base {}
+}> {}
 /** Counts and normalized bytes returned by {@link ensureParaIds}. */
 type EnsureParaIdsResult = {
   /** The normalized `.docx`; the input bytes verbatim when `alreadyComplete`. */

package/dist/docx/ensureParaIds.js

@@ -55,7 +55,7 @@ import JSZip from "jszip";
 *   explicitly allows signature invalidation after warning the user.
 */
 /** A malformed or unsupported package prevented paragraph-ID normalization. */
-var EnsureParaIdsError = class extends TaggedError("EnsureParaIdsError")() {};
+var EnsureParaIdsError = class extends TaggedError("EnsureParaIdsError") {};
 const W14_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2010/wordml";
 const MC_NAMESPACE_URI = "http://schemas.openxmlformats.org/markup-compatibility/2006";
 const MC_IGNORABLE_W14 = "w14";

package/dist/docx/imageParser.js

@@ -4,7 +4,7 @@ import { sanitizeExternalUrl } from "../utils/urlSecurity.js";
 import { WRAP_ELEMENT_NAMES, parsePositionH, parsePositionV, parseWrapElement } from "./drawingUtils.js";
 import { resolveTarget } from "./relsParser.js";
 import { isTextBoxDrawing } from "./textBoxParser.js";
-import { findByFullName, findChild, getAttribute, getChildElements, parseNumericAttribute } from "./xmlParser.js";
+import { findByFullName, findChild, getAttribute, getChildElements, parseNumericAttribute, parseOnOffValue } from "./xmlParser.js";
 //#region src/docx/imageParser.ts
 /**
 * Convert rotation value (1/60000 of a degree) to degrees
@@ -74,7 +74,7 @@ function parseDocProps(docPr) {
 	const name = getAttribute(docPr, null, "name");
 	const descr = getAttribute(docPr, null, "descr");
 	const title = getAttribute(docPr, null, "title");
-	const decorative = getAttribute(docPr, null, "decorative") === "1";
+	const decorative = parseOnOffValue(getAttribute(docPr, null, "decorative")) === true;
 	const hlinkClickEl = findChild(docPr, "a", "hlinkClick");
 	const hlinkRId = hlinkClickEl ? getAttribute(hlinkClickEl, "r", "id") : null;
 	return {
@@ -92,8 +92,8 @@ function parseDocProps(docPr) {
 function parseTransform(xfrm) {
 	if (!xfrm) return;
 	const rot = getAttribute(xfrm, null, "rot");
-	const flipH = getAttribute(xfrm, null, "flipH") === "1";
-	const flipV = getAttribute(xfrm, null, "flipV") === "1";
+	const flipH = parseOnOffValue(getAttribute(xfrm, null, "flipH")) === true;
+	const flipV = parseOnOffValue(getAttribute(xfrm, null, "flipV")) === true;
 	const rotation = rotToDegrees(rot);
 	if (rotation === void 0 && !flipH && !flipV) return;
 	const transform = {};
@@ -155,10 +155,7 @@ function parseImageCrop(blipFill) {
 * spec-defined default.
 */
 function parseOnOffAttr(element, name) {
-	const raw = getAttribute(element, null, name);
-	if (raw === null) return;
-	if (raw === "1" || raw === "true" || raw === "on") return true;
-	if (raw === "0" || raw === "false" || raw === "off") return false;
+	return parseOnOffValue(getAttribute(element, null, name));
 }
 /**
 * Parse `<a:alphaModFix amt="..."/>` inside the `a:blip` element. The
@@ -358,7 +355,7 @@ function parseAnchor(anchorEl, rels, media) {
 	const size = parseExtent(findByFullName(anchorEl, "wp:extent"));
 	const padding = parseEffectExtent(findByFullName(anchorEl, "wp:effectExtent"));
 	const props = parseDocProps(findByFullName(anchorEl, "wp:docPr"));
-	const behindDoc = getAttribute(anchorEl, null, "behindDoc") === "1";
+	const behindDoc = parseOnOffValue(getAttribute(anchorEl, null, "behindDoc")) === true;
 	const layoutInCell = parseOnOffAttr(anchorEl, "layoutInCell");
 	const allowOverlap = parseOnOffAttr(anchorEl, "allowOverlap");
 	const anchorDistT = parseNumericAttribute(anchorEl, null, "distT");

package/dist/docx/metadataPrivacy.d.ts

@@ -15,17 +15,17 @@ type RewriteDocxMetadataPrivacyResult = {
   buffer: ArrayBuffer;
   privacyReport: FolioDocumentPrivacyReport;
 };
-declare const InvalidFolioDocumentPrivacyOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocumentPrivacyOptionsError", {
+declare const InvalidFolioDocumentPrivacyOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocumentPrivacyOptionsError">;
+declare class InvalidFolioDocumentPrivacyOptionsError extends InvalidFolioDocumentPrivacyOptionsError_base<{
   message: string;
   receivedValue: unknown;
-}>;
-declare class InvalidFolioDocumentPrivacyOptionsError extends InvalidFolioDocumentPrivacyOptionsError_base {}
-declare const FolioDocumentPrivacyArchiveError_base: import("better-result").TaggedErrorClass<"FolioDocumentPrivacyArchiveError", {
+}> {}
+declare const FolioDocumentPrivacyArchiveError_base: import("better-result").TaggedErrorClass<"FolioDocumentPrivacyArchiveError">;
+declare class FolioDocumentPrivacyArchiveError extends FolioDocumentPrivacyArchiveError_base<{
   message: string;
   reason: "input-too-large" | "load-failed" | "too-many-entries" | "core-properties-too-large";
   cause?: unknown;
-}>;
-declare class FolioDocumentPrivacyArchiveError extends FolioDocumentPrivacyArchiveError_base {}
+}> {}
 declare const PRIVATE_METADATA_PROPERTIES_BY_TRANSFORM: {
   readonly "remove-attribution": readonly ["creator", "lastModifiedBy"];
   readonly "remove-timestamps": readonly ["created", "modified"];

package/dist/docx/metadataPrivacy.js

@@ -20,8 +20,8 @@ const FOLIO_DOCUMENT_PRIVACY_TRANSFORMS = Object.freeze([
 	"remove-descriptive-metadata"
 ]);
 const isFolioDocumentPrivacyTransform = (value) => FOLIO_DOCUMENT_PRIVACY_TRANSFORMS.some((transform) => transform === value);
-var InvalidFolioDocumentPrivacyOptionsError = class extends TaggedError("InvalidFolioDocumentPrivacyOptionsError")() {};
-var FolioDocumentPrivacyArchiveError = class extends TaggedError("FolioDocumentPrivacyArchiveError")() {};
+var InvalidFolioDocumentPrivacyOptionsError = class extends TaggedError("InvalidFolioDocumentPrivacyOptionsError") {};
+var FolioDocumentPrivacyArchiveError = class extends TaggedError("FolioDocumentPrivacyArchiveError") {};
 const PRIVATE_METADATA_PROPERTIES_BY_TRANSFORM = {
 	"remove-attribution": ["creator", "lastModifiedBy"],
 	"remove-timestamps": ["created", "modified"],

package/dist/docx/parser.d.ts

@@ -45,13 +45,13 @@ type ParseOptions = {
  * @throws {Error} if parsing fails
  */
 declare function parseDocx(input: DocxInput, options?: ParseOptions): Promise<document_d_exports.Document>;
-declare const DocxParseError_base: import("better-result").TaggedErrorClass<"DocxParseError", {
-  message: string;
-  cause?: unknown;
-}>;
+declare const DocxParseError_base: import("better-result").TaggedErrorClass<"DocxParseError">;
 /** DOCX parsing failure: malformed package, unsupported feature, or
  *  upstream parser exception. Wraps the original cause for diagnostics. */
-declare class DocxParseError extends DocxParseError_base {}
+declare class DocxParseError extends DocxParseError_base<{
+  message: string;
+  cause?: unknown;
+}> {}
 /**
  * Quick parse - parse a DOCX without font loading
  * Useful for quick content extraction or when fonts aren't needed

package/dist/docx/parser.js

@@ -228,7 +228,7 @@ async function parseDocx(input, options = {}) {
 }
 /** DOCX parsing failure: malformed package, unsupported feature, or
 *  upstream parser exception. Wraps the original cause for diagnostics. */
-var DocxParseError = class extends TaggedError("DocxParseError")() {};
+var DocxParseError = class extends TaggedError("DocxParseError") {};
 /**
 * Build media file map from raw content and relationships
 */

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

@@ -62,18 +62,18 @@ type FolioDocxXmlPatchApplication = {
   readonly receipt: FolioDocxXmlPatchApplicationReceipt;
   readonly bytes: Uint8Array;
 };
-declare const UnsupportedFolioDocxXmlPatchApplicationProfileError_base: import("better-result").TaggedErrorClass<"UnsupportedFolioDocxXmlPatchApplicationProfileError", {
+declare const UnsupportedFolioDocxXmlPatchApplicationProfileError_base: import("better-result").TaggedErrorClass<"UnsupportedFolioDocxXmlPatchApplicationProfileError">;
+declare class UnsupportedFolioDocxXmlPatchApplicationProfileError extends UnsupportedFolioDocxXmlPatchApplicationProfileError_base<{
   message: string;
   profile: unknown;
-}>;
-declare class UnsupportedFolioDocxXmlPatchApplicationProfileError extends UnsupportedFolioDocxXmlPatchApplicationProfileError_base {}
-declare const FolioDocxXmlPatchApplicationError_base: import("better-result").TaggedErrorClass<"FolioDocxXmlPatchApplicationError", {
+}> {}
+declare const FolioDocxXmlPatchApplicationError_base: import("better-result").TaggedErrorClass<"FolioDocxXmlPatchApplicationError">;
+declare class FolioDocxXmlPatchApplicationError extends FolioDocxXmlPatchApplicationError_base<{
   message: string;
   stage: "verify" | "load" | "replace" | "generate";
   part?: string;
   cause?: unknown;
-}>;
-declare class FolioDocxXmlPatchApplicationError extends FolioDocxXmlPatchApplicationError_base {}
+}> {}
 /** 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>;
 //#endregion

package/dist/docx/server/applyDocxXmlPatchProposal.js

@@ -8,8 +8,8 @@ import { createHash } from "node:crypto";
 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")() {};
+var UnsupportedFolioDocxXmlPatchApplicationProfileError = class extends TaggedError("UnsupportedFolioDocxXmlPatchApplicationProfileError") {};
+var FolioDocxXmlPatchApplicationError = class extends TaggedError("FolioDocxXmlPatchApplicationError") {};
 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

@@ -3,13 +3,13 @@ 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", {
+declare const DocxArchiveError_base: import("better-result").TaggedErrorClass<"DocxArchiveError">;
+/** Error raised when a DOCX archive cannot be loaded within configured limits. */
+declare class DocxArchiveError extends DocxArchiveError_base<{
   message: string;
   reason: "load-failed" | "input-too-large" | "too-many-entries" | "entry-too-large" | "total-too-large" | "invalid-options";
   cause?: unknown;
-}>;
-/** Error raised when a DOCX archive cannot be loaded within configured limits. */
-declare class DocxArchiveError extends DocxArchiveError_base {}
+}> {}
 type DocxArchiveOptions = {
   maxInputBytes?: number;
   maxEntryBytes?: number;

package/dist/docx/server/boundedArchive.js

@@ -6,7 +6,7 @@ const DOCX_MAX_TOTAL_BYTES = 256 * 1024 * 1024;
 const DOCX_MAX_ENTRIES = 4096;
 const DOCX_MAX_INPUT_BYTES = 50 * 1024 * 1024;
 /** Error raised when a DOCX archive cannot be loaded within configured limits. */
-var DocxArchiveError = class extends TaggedError("DocxArchiveError")() {};
+var DocxArchiveError = class extends TaggedError("DocxArchiveError") {};
 const collectStream = async ({ stream, maxEntryBytes, remainingBytes, maxTotalBytes, path }) => await new Promise((resolve, reject) => {
 	const chunks = [];
 	let entryBytes = 0;

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

@@ -5,16 +5,16 @@ import { ParagraphFormatting, TextFormatting } from "../../types/formatting.js";
 //#region src/docx/server/build.d.ts
 declare const HEADING_LEVELS: readonly [1, 2, 3, 4, 5, 6];
 type HeadingLevel = (typeof HEADING_LEVELS)[number];
-declare const InvalidFolioReportBuilderOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioReportBuilderOptionsError", {
-  message: string;
-  path: string;
-}>;
+declare const InvalidFolioReportBuilderOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioReportBuilderOptionsError">;
 /**
  * A builder received a value outside the model's domain (a zero `gridSpan`,
  * a negative column width, a reversed TOC range). Thrown at the boundary so
  * the invalid value never reaches the serializer.
  */
-declare class InvalidFolioReportBuilderOptionsError extends InvalidFolioReportBuilderOptionsError_base {}
+declare class InvalidFolioReportBuilderOptionsError extends InvalidFolioReportBuilderOptionsError_base<{
+  message: string;
+  path: string;
+}> {}
 declare const run: (text: string, formatting?: TextFormatting) => Run;
 declare const paragraph: (content: string | ParagraphContent[], formatting?: ParagraphFormatting) => Paragraph;
 type HeadingOptions = {

package/dist/docx/server/build.js

@@ -34,7 +34,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 TaggedError("InvalidFolioReportBuilderOptionsError") {};
 const assertPositiveInteger = (value, path) => {
 	if (!Number.isInteger(value) || value < 1) throw new InvalidFolioReportBuilderOptionsError({
 		message: `${path} must be a positive integer, got ${String(value)}`,

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

@@ -44,11 +44,11 @@ type CreateBilingualDocumentResult = {
   /** Non-fatal fidelity notes (for example an unresolvable numbering style link). */
   warnings: string[];
 };
-declare const InvalidBilingualDocumentOptionsError_base: import("better-result").TaggedErrorClass<"InvalidBilingualDocumentOptionsError", {
+declare const InvalidBilingualDocumentOptionsError_base: import("better-result").TaggedErrorClass<"InvalidBilingualDocumentOptionsError">;
+declare class InvalidBilingualDocumentOptionsError extends InvalidBilingualDocumentOptionsError_base<{
   message: string;
   option: "targetStyleSuffix";
-}>;
-declare class InvalidBilingualDocumentOptionsError extends InvalidBilingualDocumentOptionsError_base {}
+}> {}
 declare function createBilingualDocument(source: document_d_exports.Document, options: CreateBilingualDocumentOptions): CreateBilingualDocumentResult;
 /**
  * Re-derive the row manifest from a document produced by

package/dist/docx/server/createBilingualDocument.js

@@ -19,7 +19,7 @@ import { TaggedError } from "better-result";
 * and read once, and its labels are translated inline rather than duplicated.
 */
 const STYLE_SUFFIX_PATTERN = /^[A-Za-z0-9-]+$/u;
-var InvalidBilingualDocumentOptionsError = class extends TaggedError("InvalidBilingualDocumentOptionsError")() {};
+var InvalidBilingualDocumentOptionsError = class extends TaggedError("InvalidBilingualDocumentOptionsError") {};
 const FULL_WIDTH_PCT = 5e3;
 const HALF_WIDTH_PCT = 2500;
 const A4_TEXT_WIDTH_TWIPS = 9072;

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

@@ -62,17 +62,17 @@ type FolioDocxXmlPatchProposalEvaluation = {
   readonly replacements: readonly [];
   readonly limits: Required<FolioDocxXmlPatchProposalLimits>;
 };
-declare const InvalidFolioDocxXmlPatchProposalError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocxXmlPatchProposalError", {
+declare const InvalidFolioDocxXmlPatchProposalError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocxXmlPatchProposalError">;
+declare class InvalidFolioDocxXmlPatchProposalError extends InvalidFolioDocxXmlPatchProposalError_base<{
   message: string;
   path: string;
   reason: string;
-}>;
-declare class InvalidFolioDocxXmlPatchProposalError extends InvalidFolioDocxXmlPatchProposalError_base {}
-declare const InvalidFolioDocxXmlPatchProposalOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocxXmlPatchProposalOptionsError", {
+}> {}
+declare const InvalidFolioDocxXmlPatchProposalOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocxXmlPatchProposalOptionsError">;
+declare class InvalidFolioDocxXmlPatchProposalOptionsError extends InvalidFolioDocxXmlPatchProposalOptionsError_base<{
   message: string;
   path: string;
-}>;
-declare class InvalidFolioDocxXmlPatchProposalOptionsError extends InvalidFolioDocxXmlPatchProposalOptionsError_base {}
+}> {}
 declare const parseFolioDocxXmlPatchProposal: (value: unknown) => FolioDocxXmlPatchProposal;
 declare const evaluateDocxXmlPatchProposal: ({ bytes, proposal: rawProposal, allowedParts, archive, limits: rawLimits }: EvaluateDocxXmlPatchProposalArgs) => Promise<FolioDocxXmlPatchProposalEvaluation>;
 //#endregion

package/dist/docx/server/evaluateDocxXmlPatchProposal.js

@@ -29,8 +29,8 @@ const FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES = Object.freeze([
 	"base-hash-mismatch",
 	"package-inspection-failed"
 ]);
-var InvalidFolioDocxXmlPatchProposalError = class extends TaggedError("InvalidFolioDocxXmlPatchProposalError")() {};
-var InvalidFolioDocxXmlPatchProposalOptionsError = class extends TaggedError("InvalidFolioDocxXmlPatchProposalOptionsError")() {};
+var InvalidFolioDocxXmlPatchProposalError = class extends TaggedError("InvalidFolioDocxXmlPatchProposalError") {};
+var InvalidFolioDocxXmlPatchProposalOptionsError = class extends TaggedError("InvalidFolioDocxXmlPatchProposalOptionsError") {};
 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/inspectDocxPackage.d.ts

@@ -8,13 +8,13 @@ declare const FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS: Readonly<{
 }>;
 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 const FolioDocxPackageInspectionError_base: import("better-result").TaggedErrorClass<"FolioDocxPackageInspectionError">;
+declare class FolioDocxPackageInspectionError extends FolioDocxPackageInspectionError_base<{
   message: string;
   code: FolioDocxPackageInspectionErrorCode;
   part?: string;
   cause?: unknown;
-}>;
-declare class FolioDocxPackageInspectionError extends FolioDocxPackageInspectionError_base {}
+}> {}
 type FolioDocxPackageInspectionLimits = {
   readonly maxXmlParts?: number;
   readonly maxXmlPartBytes?: number;

package/dist/docx/server/inspectDocxPackage.js

@@ -1,6 +1,6 @@
 import { getAttributeAnyPrefix, getLocalName, parseXmlDocument } from "../xmlParser.js";
 import { DocxArchiveError, loadDocxArchive } from "./boundedArchive.js";
-import { TaggedError } from "better-result";
+import { Result, TaggedError } from "better-result";
 import { createHash } from "node:crypto";
 //#region src/docx/server/inspectDocxPackage.ts
 const FOLIO_DOCX_PACKAGE_INSPECTION_VERSION = 1;
@@ -19,7 +19,7 @@ const FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES = Object.freeze([
 	"xml-total-too-large",
 	"xml-decode-failed"
 ]);
-var FolioDocxPackageInspectionError = class extends TaggedError("FolioDocxPackageInspectionError")() {};
+var FolioDocxPackageInspectionError = class extends TaggedError("FolioDocxPackageInspectionError") {};
 const CONTENT_TYPES_PATH = "[Content_Types].xml";
 const CONTENT_TYPES_READ_LIMIT = 4 * 1024 * 1024;
 const XML_PATH_PATTERN = /(?:\.xml|\.rels)$/iu;
@@ -32,16 +32,17 @@ const decodeXml = (bytes, part) => {
 	let encoding = "utf-8";
 	if (bytes.length >= 2 && (bytes[0] === 255 && bytes[1] === 254 || bytes[0] === 60 && bytes[1] === 0)) encoding = "utf-16le";
 	else if (bytes.length >= 2 && (bytes[0] === 254 && bytes[1] === 255 || bytes[0] === 0 && bytes[1] === 60)) encoding = "utf-16be";
-	try {
-		return new TextDecoder(encoding, { fatal: true }).decode(bytes);
-	} catch (cause) {
-		throw new FolioDocxPackageInspectionError({
+	const decoded = Result.try({
+		try: () => new TextDecoder(encoding, { fatal: true }).decode(bytes),
+		catch: (cause) => new FolioDocxPackageInspectionError({
 			message: `Failed to decode XML package part "${part}"`,
 			code: "xml-decode-failed",
 			part,
 			cause
-		});
-	}
+		})
+	});
+	if (decoded.isOk()) return decoded.value;
+	throw decoded.error;
 };
 const parseContentTypes = (xml) => {
 	const declarations = {