@stll/folio-core 0.63.1 → 0.64.1

package/dist/docx/tableParser.js

@@ -18,7 +18,7 @@ import { percentageSpelling, transitionalSlotEncoding } from "./transitionalSpel
 import { captureVerbatimXml } from "./verbatimCapture.js";
 import { WORDPROCESSINGML_NAMESPACE_URIS, cloneElement, findChild, findChildren, findWordprocessingChild, getAttribute, getAttributeByNamespaceUri, getChildElements, getLocalName, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, parseOnOffAttribute, parseTableMeasurementValue, selectAlternateContentBranch } from "./xmlParser.js";
 import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
-//#region src/docx/tableParser.ts
+// src/docx/tableParser.ts
 /**
 * Sanity cap on `w:gridSpan` (and the derived table column count). Word's
 * practical column limit is 63; a hostile/corrupt value here would blow up
@@ -1434,5 +1434,4 @@ function getHeaderRows(table) {
 function isFloatingTable(table) {
 	return table.formatting?.floating !== void 0;
 }
-//#endregion
 export { CELL_CONTENT_HANDLERS, MAX_TABLE_COLUMNS, ROW_CONTENT_HANDLERS, TABLE_CONTENT_HANDLERS, getHeaderRows, getTableColumnCount, getTableRowCount, hasHeaderRow, isCellHorizontallyMerged, isCellMergeContinuation, isCellMergeStart, isFloatingTable, isTableCellMergeRevisionContinuation, isTableCellMergeRevisionValue, parseCellMargins, parseConditionalFormatStyle, parseFloatingTableProperties, parseTable, parseTableBorders, parseTableCell, parseTableCellProperties, parseTableGrid, parseTableLook, parseTableMeasurement, parseTableProperties, parseTablePropertyExceptions, parseTableRow, parseTableRowProperties };

package/dist/docx/tableRowPropertyPresence.d.ts

@@ -1,8 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/tableRowPropertyPresence.d.ts
 export declare const EMPTY_ROW_PROPERTIES_ATTRIBUTE = "emptyRowProperties";
 export declare const retainsEmptyRowProperties: (element: XmlElement) => boolean;
 export declare const serializeEmptyRowProperties: (row: document_d_exports.TableRow) => string[];
-export declare const isEmptyRowPropertiesAttribute: ({ namespace, name }: Pick<document_d_exports.PreservedAttribute, "namespace" | "name">) => boolean;
-//#endregion
+export declare const isEmptyRowPropertiesAttribute: ({ namespace, name }: Pick<document_d_exports.PreservedAttribute, "namespace" | "name">) => boolean;

package/dist/docx/tableRowPropertyPresence.js

@@ -1,7 +1,7 @@
 import { OOXML_NAMESPACES } from "./serializer/partNamespaces.js";
 import { getAttributeByNamespaceUri } from "./xmlParser.js";
 import { EMPTY_PROPERTY_SETS } from "@stll/docx-core/ops";
-//#region src/docx/tableRowPropertyPresence.ts
+// src/docx/tableRowPropertyPresence.ts
 const EMPTY_ROW_PROPERTIES_ATTRIBUTE = "emptyRowProperties";
 const HISTORY_NAMESPACES = /* @__PURE__ */ new Set([OOXML_NAMESPACES.folio.uri]);
 const retainsEmptyRowProperties = (element) => getAttributeByNamespaceUri(element, HISTORY_NAMESPACES, EMPTY_ROW_PROPERTIES_ATTRIBUTE) === EMPTY_PROPERTY_SETS.KEEP;
@@ -11,5 +11,4 @@ const serializeEmptyRowProperties = (row) => {
 	return Object.keys(properties).length === 0 ? [`folio:${EMPTY_ROW_PROPERTIES_ATTRIBUTE}="${EMPTY_PROPERTY_SETS.KEEP}"`] : [];
 };
 const isEmptyRowPropertiesAttribute = ({ namespace, name }) => namespace === OOXML_NAMESPACES.folio.uri && name === "emptyRowProperties";
-//#endregion
 export { EMPTY_ROW_PROPERTIES_ATTRIBUTE, isEmptyRowPropertiesAttribute, retainsEmptyRowProperties, serializeEmptyRowProperties };

package/dist/docx/textBoxParser.d.ts

@@ -4,7 +4,6 @@ import { ParseContext } from "./parseContext.js";
 import { XmlElement } from "./xmlParser.js";
 import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
-//#region src/docx/textBoxParser.d.ts
 /**
  * Extract raw paragraph elements from w:txbxContent
  * Actual parsing happens via document parser to avoid circular dependencies
@@ -145,5 +144,4 @@ export type ScanRunForTextBoxDrawingsOptions = {
    */
   claimedByRunParser: (pictElement: XmlElement) => boolean;
 };
-export declare const scanRunForTextBoxDrawings: ({ xmlRun, claimedByRunParser }: ScanRunForTextBoxDrawingsOptions) => TextBoxRunScan;
-//#endregion
+export declare const scanRunForTextBoxDrawings: ({ xmlRun, claimedByRunParser }: ScanRunForTextBoxDrawingsOptions) => TextBoxRunScan;

package/dist/docx/textBoxParser.js

@@ -3,7 +3,7 @@ import { WORDPROCESSING_DRAWING_NAMESPACE_URIS, parseDrawingAnchor } from "./dra
 import { parseAnchorPosition, parseAnchorWrap, parseFill, parseInlineWrap, parseOutline, resolveColorValueToHex } from "./drawingUtils.js";
 import { parseNonVisualDrawingNames } from "./nonVisualDrawingProps.js";
 import { WORDPROCESSINGML_NAMESPACE_URIS, findChildByLocalName, findChildByNamespaceUri, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, getAttribute, getChildElements, getLocalName, parseNumericAttribute, parseOnOffAttribute } from "./xmlParser.js";
-//#region src/docx/textBoxParser.ts
+// src/docx/textBoxParser.ts
 const DRAWINGML_MAIN_NAMESPACE_URIS = /* @__PURE__ */ new Set(["http://schemas.openxmlformats.org/drawingml/2006/main", "http://purl.oclc.org/ooxml/drawingml/main"]);
 const WORDPROCESSING_SHAPE_NAMESPACE_URIS = /* @__PURE__ */ new Set(["http://schemas.microsoft.com/office/word/2010/wordprocessingShape"]);
 /** Default text box margins in EMUs (0.1 inch) */
@@ -359,5 +359,4 @@ const scanRunForTextBoxDrawings = ({ xmlRun, claimedByRunParser }) => {
 		hasNonTextBoxContent
 	};
 };
-//#endregion
 export { extractTextBoxContentElements, getTextBoxContentElement, getTextBoxDimensionsPx, getTextBoxHeightPx, getTextBoxMarginsPx, getTextBoxOutlineWidthPx, getTextBoxWidthPx, hasTextBoxContent, hasTextBoxFill, hasTextBoxOutline, isFloatingTextBox, isShapeTextBox, isTextBoxDrawing, parseTextBox, parseTextBoxContent, parseTextBoxFromShape, resolveTextBoxFillColor, resolveTextBoxOutlineColor, scanRunForTextBoxDrawings };

package/dist/docx/themeColorAttribute.d.ts

@@ -1,6 +1,5 @@
 import { ParseContext } from "./parseContext.js";
 import { ThemeColorValue } from "@stll/docx-core/model";
-//#region src/docx/themeColorAttribute.d.ts
 export type ThemeColorAttributeOptions = {
   /** The attribute as written, or `null` when the element does not carry it. */
   raw: string | null | undefined;
@@ -8,5 +7,4 @@ export type ThemeColorAttributeOptions = {
   element?: string | undefined;
   context?: ParseContext | undefined;
 };
-export declare const parseThemeColorAttribute: ({ raw, element, context }: ThemeColorAttributeOptions) => ThemeColorValue | undefined;
-//#endregion
+export declare const parseThemeColorAttribute: ({ raw, element, context }: ThemeColorAttributeOptions) => ThemeColorValue | undefined;

package/dist/docx/themeColorAttribute.js

@@ -1,5 +1,5 @@
 import { PARSE_WARNING_CODES, readThemeColor } from "@stll/docx-core/model";
-//#region src/docx/themeColorAttribute.ts
+// src/docx/themeColorAttribute.ts
 /**
 * The one reader for a theme-colour attribute.
 *
@@ -20,5 +20,4 @@ const parseThemeColorAttribute = ({ raw, element, context }) => {
 	});
 	return value;
 };
-//#endregion
 export { parseThemeColorAttribute };

package/dist/docx/themeParser.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/themeParser.d.ts
 /**
  * Parse theme1.xml content
  *
@@ -71,5 +70,4 @@ export declare function getThemeFonts(theme: document_d_exports.Theme | null | u
  *
  * @returns Default Theme object
  */
-export declare function getDefaultTheme(): document_d_exports.Theme;
-//#endregion
+export declare function getDefaultTheme(): document_d_exports.Theme;

package/dist/docx/themeParser.js

@@ -1,5 +1,5 @@
 import { findChild, findChildren, getAttribute, getChildElements, getLocalName, parseXmlDocument } from "./xmlParser.js";
-//#region src/docx/themeParser.ts
+// src/docx/themeParser.ts
 /**
 * Default theme colors (Office 2016 default theme)
 * Used when theme1.xml is missing or malformed
@@ -326,5 +326,4 @@ function getThemeFonts(theme) {
 function getDefaultTheme() {
 	return { ...DEFAULT_THEME };
 }
-//#endregion
 export { applyThemeFontLang, getDefaultTheme, getMajorFont, getMinorFont, getThemeColor, getThemeFonts, parseTheme, resolveThemeFontRef };

package/dist/docx/trackedChangeInfo.d.ts

@@ -1,10 +1,8 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/trackedChangeInfo.d.ts
 export declare const DATE_UTC_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2023/wordml/word16du";
 export declare const DATE_UTC_ATTRIBUTE = "w16du:dateUtc";
 /** Parse the metadata shared by every WordprocessingML tracked-change element. */
 export declare const parseTrackedChangeInfo: (node: XmlElement) => document_d_exports.TrackedChangeInfo;
 /** Parse the shared metadata plus the optional property-change revision session. */
-export declare const parsePropertyChangeInfo: (node: XmlElement) => document_d_exports.PropertyChangeInfo;
-//#endregion
+export declare const parsePropertyChangeInfo: (node: XmlElement) => document_d_exports.PropertyChangeInfo;

package/dist/docx/trackedChangeInfo.js

@@ -1,6 +1,6 @@
 import { WORDPROCESSINGML_NAMESPACE_URIS, findAttributeByNamespaceUri, getAttributeByNamespaceUri } from "./xmlParser.js";
 import { normalizeRevisionId } from "@stll/docx-core/model";
-//#region src/docx/trackedChangeInfo.ts
+// src/docx/trackedChangeInfo.ts
 const DATE_UTC_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2023/wordml/word16du";
 const DATE_UTC_ATTRIBUTE = "w16du:dateUtc";
 const DATE_UTC_NAMESPACE_URIS = /* @__PURE__ */ new Set([DATE_UTC_NAMESPACE_URI]);
@@ -34,5 +34,4 @@ const parsePropertyChangeInfo = (node) => {
 		rsid
 	} : info;
 };
-//#endregion
 export { DATE_UTC_ATTRIBUTE, DATE_UTC_NAMESPACE_URI, parsePropertyChangeInfo, parseTrackedChangeInfo };

package/dist/docx/trackedMoveRangeNormalization.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/trackedMoveRangeNormalization.d.ts
 /** The code this normalisation is reported under, owned here, not at the caller. */
 export declare const UNBALANCED_MOVE_RANGE_WARNING: "unbalanced-move-range";
 type NormalizeTrackedMoveRangesInput = {
@@ -13,5 +12,4 @@ type NormalizeTrackedMoveRangesResult = {
   removedUnbalancedMoveRangeMarkers: number;
 };
 export declare const normalizeTrackedMoveRanges: ({ documentBody, headers, footers, footnotes, endnotes }: NormalizeTrackedMoveRangesInput) => NormalizeTrackedMoveRangesResult;
-//#endregion
 export {};

package/dist/docx/trackedMoveRangeNormalization.js

@@ -3,7 +3,7 @@ import { InlineContentRemovals } from "./inlineContentRemovals.js";
 import { visitDocxContentSlots } from "./paragraphTraversal.js";
 import { panic } from "better-result";
 import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
-//#region src/docx/trackedMoveRangeNormalization.ts
+// src/docx/trackedMoveRangeNormalization.ts
 /** The code this normalisation is reported under, owned here, not at the caller. */
 const UNBALANCED_MOVE_RANGE_WARNING = PARSE_WARNING_CODES.unbalancedMoveRange;
 const normalizeTrackedMoveRanges = ({ documentBody, headers, footers, footnotes, endnotes }) => {
@@ -118,5 +118,4 @@ const toMoveRangeMarkerRef = (slot) => {
 	};
 	return null;
 };
-//#endregion
 export { UNBALANCED_MOVE_RANGE_WARNING, normalizeTrackedMoveRanges };

package/dist/docx/transitionalSpelling.d.ts

@@ -1,5 +1,4 @@
 import { PercentUnit, SlotEncoding } from "./strictValueEncodings.gen.js";
-//#region src/docx/transitionalSpelling.d.ts
 /**
  * The Transitional URI a Strict one stands for, or the URI unchanged.
  *
@@ -29,5 +28,4 @@ export declare const percentageSpelling: (value: string) => number | undefined;
  * `namespaceUri` is the element's, in either conformance class; the lookup
  * translates it. Omit `attributeLocalName` for element text content.
  */
-export declare const transitionalSlotEncoding: (namespaceUri: string | undefined, elementLocalName: string, attributeLocalName?: string) => SlotEncoding | undefined;
-//#endregion
+export declare const transitionalSlotEncoding: (namespaceUri: string | undefined, elementLocalName: string, attributeLocalName?: string) => SlotEncoding | undefined;

package/dist/docx/transitionalSpelling.js

@@ -1,5 +1,5 @@
 import { TRANSITIONAL_NAMESPACE_BY_STRICT_URI, TRANSITIONAL_SLOT_ENCODINGS } from "./strictValueEncodings.gen.js";
-//#region src/docx/transitionalSpelling.ts
+// src/docx/transitionalSpelling.ts
 /**
 * Reading a Strict-spelled value as the Transitional number it stands for.
 *
@@ -54,5 +54,4 @@ const transitionalSlotEncoding = (namespaceUri, elementLocalName, attributeLocal
 	const slot = `${toTransitionalNamespaceUri(namespaceUri)} ${elementLocalName}`;
 	return TRANSITIONAL_SLOT_ENCODINGS.get(attributeLocalName === void 0 ? slot : `${slot} @${attributeLocalName}`);
 };
-//#endregion
 export { NUMBERS_PER_PERCENT, STRICT_URI_PREFIX, isStrictNamespaceUri, percentageSpelling, toTransitionalNamespaceUri, transitionalSlotEncoding };

package/dist/docx/universalMeasure.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/universalMeasure.d.ts
 /**
  * ECMA-376's unit-carrying length, and the numbers Transitional counts it in.
  *
@@ -15,5 +14,4 @@ export declare const roundHalfAwayFromZero: (value: number) => number;
 /** The value of a universal measure in points, or `undefined` if it is not one. */
 export declare const universalMeasureInPoints: (value: string) => number | undefined;
 /** A universal measure as the whole number a Transitional attribute of `unit` holds. */
-export declare const universalMeasureAs: (value: string, unit: MeasureUnit) => number | undefined;
-//#endregion
+export declare const universalMeasureAs: (value: string, unit: MeasureUnit) => number | undefined;

package/dist/docx/universalMeasure.js

@@ -1,4 +1,4 @@
-//#region src/docx/universalMeasure.ts
+// src/docx/universalMeasure.ts
 /** `-?123.45pt`: the one shape ECMA-376 gives a length that carries its unit. */
 const UNIVERSAL_MEASURE = /^(-?[0-9]+(?:\.[0-9]+)?)(mm|cm|in|pt|pc|pi)$/u;
 const POINTS_PER_UNIT = {
@@ -28,5 +28,4 @@ const universalMeasureAs = (value, unit) => {
 	const points = universalMeasureInPoints(value);
 	return points === void 0 ? void 0 : roundHalfAwayFromZero(points * NUMBERS_PER_POINT[unit]);
 };
-//#endregion
 export { roundHalfAwayFromZero, universalMeasureAs, universalMeasureInPoints };

package/dist/docx/unzip.d.ts

@@ -1,5 +1,4 @@
 import JSZip from "jszip";
-//#region src/docx/unzip.d.ts
 export declare class DocxSecurityError extends Error {
   constructor(message: string);
 }
@@ -160,5 +159,4 @@ export declare function getContentSummary(content: RawDocxContent): {
   mediaCount: number;
   fontCount: number;
   totalFiles: number;
-};
-//#endregion
+};

package/dist/docx/unzip.js

@@ -8,7 +8,7 @@ import { decodeXmlBytes } from "./xmlEncoding.js";
 import { FOLIO_XML_RESOURCE_LIMITS, assertXmlResourceLimits, createXmlPackageBudget } from "./xmlResourceLimits.js";
 import JSZip from "jszip";
 import { writeZipPart } from "@stll/docx-core/zip";
-//#region src/docx/unzip.ts
+// src/docx/unzip.ts
 /**
 * DOCX Unzipper
 *
@@ -630,5 +630,4 @@ function getContentSummary(content) {
 		totalFiles: Object.keys(content.originalZip.files).filter((p) => !content.originalZip.files[p]?.dir).length
 	};
 }
-//#endregion
 export { DocxSecurityError, extractFile, getContentSummary, getEntryUncompressedSize, getFileList, getMediaMimeType, hasFile, mediaToDataUrl, replaceRawDocxXmlParts, unzipDocx };

package/dist/docx/verbatimCapture.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement, XmlNamespaceScope } from "./xmlParser.js";
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/verbatimCapture.d.ts
 declare const UntranslatableStrictNamespaceErrorBase: TaggedErrorClass<"UntranslatableStrictNamespaceError">;
 /** A Strict fragment uses a namespace that has no Transitional counterpart. */
 export declare class UntranslatableStrictNamespaceError extends UntranslatableStrictNamespaceErrorBase<{
@@ -32,5 +31,4 @@ export declare const isSafeCapturedXmlDocument: (xml: string) => boolean;
  */
 export declare const createCapturedXmlSanitizer: (options: SanitizeCapturedXmlOptions) => ((xml: string | undefined) => string | null);
 export declare const captureSourceProfileXml: (element: XmlElement, conformance: document_d_exports.DocxConformanceClass | undefined) => string;
-//#endregion
 export {};

package/dist/docx/verbatimCapture.js

@@ -6,7 +6,7 @@ import { assertXmlResourceLimits } from "./xmlResourceLimits.js";
 import { getDocxXmlSafetyIssue } from "./xmlSafety.js";
 import { TaggedError, panic } from "better-result";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
-//#region src/docx/verbatimCapture.ts
+// src/docx/verbatimCapture.ts
 /**
 * The one way to turn parsed markup into a string a rebuilt part replays.
 *
@@ -408,5 +408,4 @@ const captureSourceProfileXml = (element, conformance) => {
 	if (!isSafeCapturedXmlDocument(xml)) panic("Generated source-profile markup is unsafe.");
 	return xml;
 };
-//#endregion
 export { UntranslatableStrictNamespaceError, captureSourceProfileXml, captureVerbatimXml, createCapturedXmlSanitizer, isSafeCapturedXmlDocument };

package/dist/docx/verticalMergeProjection.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/verticalMergeProjection.d.ts
 /** The reader and revision resolver share which continuation cells remain visible. */
 export type RowSpanInfo = {
   rowSpan: number;
@@ -12,5 +11,4 @@ export declare function calculateRowSpans(table: document_d_exports.Table): Map<
  * Whether a cell carries content a vertical-merge continuation must not hide.
  * The reader keeps such a continuation as a cell of its own.
  */
-export declare function tableCellHasMeaningfulContent(cell: document_d_exports.TableCell): boolean;
-//#endregion
+export declare function tableCellHasMeaningfulContent(cell: document_d_exports.TableCell): boolean;

package/dist/docx/verticalMergeProjection.js

@@ -1,5 +1,5 @@
 import { isCellMergeContinuation } from "./tableParser.js";
-//#region src/docx/verticalMergeProjection.ts
+// src/docx/verticalMergeProjection.ts
 function calculateRowSpans(table) {
 	const result = /* @__PURE__ */ new Map();
 	const numRows = table.rows.length;
@@ -116,5 +116,4 @@ function paragraphContentHasMeaningfulContent(content) {
 	if (content.type === "insertion" || content.type === "deletion" || content.type === "moveFrom" || content.type === "moveTo") return content.content.some(paragraphContentHasMeaningfulContent);
 	return true;
 }
-//#endregion
 export { calculateRowSpans, tableCellHasMeaningfulContent };

package/dist/docx/vmlImageParser.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
 import { PreviewLedger } from "./previewBudget.js";
-//#region src/docx/vmlImageParser.d.ts
 /**
  * Whether a `w:pict` that resolved to no image must still be kept verbatim.
  *
@@ -47,5 +46,4 @@ export declare function parseVmlImageContent(pictElement: XmlElement, rels: docu
  * either result: a preview built here would be registered against the package
  * budget for a drawing the model never holds.
  */
-export declare const isVmlPictParsedByRunParser: (pictElement: XmlElement, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null) => boolean;
-//#endregion
+export declare const isVmlPictParsedByRunParser: (pictElement: XmlElement, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null) => boolean;

package/dist/docx/vmlImageParser.js

@@ -7,7 +7,7 @@ import { fitsVmlSvgCap, isValidVmlPreviewDimension, parseVmlNumber, parseVmlStyl
 import { isWatermarkShape } from "./watermarkParser.js";
 import { cloneWithXmlnsDeclarations, findAllDeep, findChild, findDeep, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
 import { DRAWING_RAW_XML_MODES, relationshipIdOf } from "@stll/docx-core/model";
-//#region src/docx/vmlImageParser.ts
+// src/docx/vmlImageParser.ts
 /**
 * VML image parser — legacy `w:pict` inline pictures.
 *
@@ -274,5 +274,4 @@ function parseVmlImageContent(pictElement, rels, media, previews, rootXmlns = {}
 * budget for a drawing the model never holds.
 */
 const isVmlPictParsedByRunParser = (pictElement, rels, media) => vmlPictPicture(pictElement, rels, media) !== null || vmlPictPreview(pictElement) !== null || shouldPreserveRawVmlPict(pictElement);
-//#endregion
 export { isVmlPictParsedByRunParser, parseVmlImageContent, shouldPreserveRawVmlPict };

package/dist/docx/vmlPreview.d.ts

@@ -1,5 +1,4 @@
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/vmlPreview.d.ts
 export type VmlPreviewResult = {
   type: "rendered";
   svg: string;
@@ -24,5 +23,4 @@ export declare const fitsVmlSvgCap: (svg: string) => boolean;
 /** Render a bounded standalone VML rectangle or oval preview. */
 export declare const renderStandaloneVmlPreview: (shape: XmlElement) => VmlPreviewResult;
 /** Render a VML group through bounded, non-clipping local-coordinate transforms. */
-export declare const renderVmlGroupPreview: (group: XmlElement) => VmlPreviewResult;
-//#endregion
+export declare const renderVmlGroupPreview: (group: XmlElement) => VmlPreviewResult;

package/dist/docx/vmlPreview.js

@@ -1,5 +1,5 @@
 import { findChild, findDeep, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
-//#region src/docx/vmlPreview.ts
+// src/docx/vmlPreview.ts
 const MAX_VML_PREVIEW_DEPTH = 16;
 const MAX_VML_PREVIEW_ELEMENTS = 256;
 const MAX_VML_PREVIEW_PATH_POINTS = 2e4;
@@ -499,5 +499,4 @@ const renderVmlGroupPreview = (group) => {
 		style
 	};
 };
-//#endregion
 export { fitsVmlSvgCap, isValidVmlPreviewDimension, parseVmlNumber, parseVmlStyle, renderStandaloneVmlPreview, renderVmlGroupPreview, vmlCssLengthToPx };

package/dist/docx/watermarkParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/watermarkParser.d.ts
 /**
  * Result of walking a header for its watermark. Carries the modeled
  * `Watermark`, the verbatim XML of the paragraph that hosts the
@@ -37,5 +36,4 @@ export declare function isWatermarkShape(shape: XmlElement): boolean;
  * paragraph (so the serializer can replay it byte-exact), and a
  * reference to that paragraph so the regular body parser can skip it.
  */
-export declare function parseWatermark(header: XmlElement): ParsedWatermark | undefined;
-//#endregion
+export declare function parseWatermark(header: XmlElement): ParsedWatermark | undefined;

package/dist/docx/watermarkParser.js

@@ -1,7 +1,7 @@
 import { parseAnchorBehindDoc } from "./drawingUtils.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
 import { cloneWithXmlnsDeclarations, collectXmlnsDeclarations, findChild, findChildren, findDeep, getAttribute, getLocalName, getTextContent } from "./xmlParser.js";
-//#region src/docx/watermarkParser.ts
+// src/docx/watermarkParser.ts
 const VML_TEXT_WATERMARK_SHAPETYPE = "#_x0000_t136";
 /**
 * Word's own UI emits picture watermarks with a shape id beginning
@@ -343,5 +343,4 @@ function stripQuotes(value) {
 	if (primary.length >= 2 && (matchedDouble || matchedSingle)) return primary.slice(1, -1);
 	return primary;
 }
-//#endregion
 export { isWatermarkShape, parseWatermark };

package/dist/docx/wmfSvg.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/wmfSvg.d.ts
 /**
  * Render a deliberately small, browser-safe WMF subset to generated SVG.
  *
@@ -6,5 +5,4 @@
  * Unsupported records fail closed; original WMF bytes remain authoritative.
  */
 /** Convert the supported WMF vector subset to inert generated SVG. */
-export declare function renderWmfSvg(data: ArrayBuffer | Uint8Array): string | null;
-//#endregion
+export declare function renderWmfSvg(data: ArrayBuffer | Uint8Array): string | null;

package/dist/docx/wmfSvg.js

@@ -1,5 +1,5 @@
 import { assembleMetafileSvg, metafileColorRefToCss, metafileNumberText, transformMetafilePoint } from "./metafileSvgShared.js";
-//#region src/docx/wmfSvg.ts
+// src/docx/wmfSvg.ts
 /**
 * Render a deliberately small, browser-safe WMF subset to generated SVG.
 *
@@ -447,5 +447,4 @@ function renderWmfSvg(data) {
 		maxCharacters: MAX_WMF_OUTPUT_CHARACTERS
 	});
 }
-//#endregion
 export { renderWmfSvg };

package/dist/docx/wordprocessingPrefixes.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/wordprocessingPrefixes.d.ts
 /**
  * Which prefixes a WordprocessingML part spells its namespaces with.
  *
@@ -73,5 +72,4 @@ export declare const closeTagLiteral: (prefix: string, localName: string) => str
  */
 export declare const matchOpenTag: (xml: string, start: number, prefixes: readonly string[], localName: string) => number;
 /** The length of the close tag of `localName` under one of `prefixes` at `start`, or -1. */
-export declare const matchCloseTag: (xml: string, start: number, prefixes: readonly string[], localName: string) => number;
-//#endregion
+export declare const matchCloseTag: (xml: string, start: number, prefixes: readonly string[], localName: string) => number;

package/dist/docx/wordprocessingPrefixes.js

@@ -1,5 +1,5 @@
 import { NAMESPACES, WORDPROCESSINGML_NAMESPACE_URIS, getLocalName, getNamespacePrefix, getNamespaceUri, parseXmlDocument, resolveAttributeNamespaceUri } from "./xmlParser.js";
-//#region src/docx/wordprocessingPrefixes.ts
+// src/docx/wordprocessingPrefixes.ts
 /**
 * Which prefixes a WordprocessingML part spells its namespaces with.
 *
@@ -282,5 +282,4 @@ const matchCloseTag = (xml, start, prefixes, localName) => {
 	}
 	return -1;
 };
-//#endregion
 export { PARAGRAPH_SCAN_NAMES, closeTagLiteral, hasCanonicalWordprocessingPrefixes, matchCloseTag, matchOpenTag, openTagLiteral, resolveSelectiveScanPrefixes, resolveWordprocessingPrefixes, splicesAsCanonical };

package/dist/docx/wrapPolygon.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/wrapPolygon.d.ts
 /**
  * The polygon a `wp:wrapTight` or `wp:wrapThrough` states: the authored one, or
  * the rectangle when the model holds none.
@@ -25,5 +24,4 @@ export declare const wrapPolygonFor: (type: document_d_exports.ImageWrap["type"]
 /** A copy, deep enough that a ProseMirror attr cannot share a point with the model. */
 export declare const copiedWrapPolygon: (polygon: document_d_exports.ImageWrapPolygon | undefined) => document_d_exports.ImageWrapPolygon | undefined;
 /** `wp:wrapPolygon`, written from a polygon {@link wrapPolygonFor} has approved. */
-export declare const serializeWrapPolygon: (polygon: document_d_exports.ImageWrapPolygon) => string;
-//#endregion
+export declare const serializeWrapPolygon: (polygon: document_d_exports.ImageWrapPolygon) => string;

package/dist/docx/wrapPolygon.js

@@ -1,5 +1,5 @@
 import { intAttr } from "./serializer/xmlUtils.js";
-//#region src/docx/wrapPolygon.ts
+// src/docx/wrapPolygon.ts
 /** `CT_WrapPath` coordinates are relative to a box of this many units. */
 const WRAP_PATH_EXTENT = 21600;
 /**
@@ -66,5 +66,4 @@ const serializeWrapPolygon = (polygon) => {
 	const lineTo = polygon.lineTo.map((point) => `<wp:lineTo x="${intAttr(point.x)}" y="${intAttr(point.y)}"/>`).join("");
 	return `<wp:wrapPolygon${edited}><wp:start x="${intAttr(polygon.start.x)}" y="${intAttr(polygon.start.y)}"/>${lineTo}</wp:wrapPolygon>`;
 };
-//#endregion
 export { copiedWrapPolygon, requiredWrapPolygon, serializeWrapPolygon, wrapPolygonFor };

package/dist/docx/xmlEncoding.d.ts

@@ -1,4 +1,2 @@
-//#region src/docx/xmlEncoding.d.ts
 /** Decode the UTF-8 and UTF-16 encodings XML processors must recognize. */
-export declare const decodeXmlBytes: (bytes: Uint8Array) => string;
-//#endregion
+export declare const decodeXmlBytes: (bytes: Uint8Array) => string;

package/dist/docx/xmlEncoding.js

@@ -1,5 +1,5 @@
 import { decodeText } from "../utils/textEncoding.js";
-//#region src/docx/xmlEncoding.ts
+// src/docx/xmlEncoding.ts
 /** Decode the UTF-8 and UTF-16 encodings XML processors must recognize. */
 const decodeXmlBytes = (bytes) => {
 	if (bytes[0] === 255 && bytes[1] === 254) return decodeText(bytes.subarray(2), { encoding: "utf-16le" });
@@ -9,5 +9,4 @@ const decodeXmlBytes = (bytes) => {
 	const utf8Offset = bytes[0] === 239 && bytes[1] === 187 && bytes[2] === 191 ? 3 : 0;
 	return decodeText(bytes.subarray(utf8Offset), { encoding: "utf-8" });
 };
-//#endregion
 export { decodeXmlBytes };

package/dist/docx/xmlNamespaceContext.d.ts

@@ -1,8 +1,6 @@
 import { XmlElement, XmlNamespaceScope } from "./xmlParser.js";
-//#region src/docx/xmlNamespaceContext.d.ts
 export declare const EMPTY_NAMESPACE_SCOPE: XmlNamespaceScope;
 export declare const XML_NAMESPACE_URI = "http://www.w3.org/XML/1998/namespace";
 export declare const resolveNamespaceUri: (scope: XmlNamespaceScope | undefined, prefix: string) => string | undefined;
 /** Attach the element's resolved namespace metadata from its in-scope declarations. */
-export declare const attachXmlNamespaceContext: (element: XmlElement, inheritedNamespaceScope?: XmlNamespaceScope) => XmlNamespaceScope;
-//#endregion
+export declare const attachXmlNamespaceContext: (element: XmlElement, inheritedNamespaceScope?: XmlNamespaceScope) => XmlNamespaceScope;

package/dist/docx/xmlNamespaceContext.js

@@ -1,4 +1,4 @@
-//#region src/docx/xmlNamespaceContext.ts
+// src/docx/xmlNamespaceContext.ts
 const EMPTY_NAMESPACE_SCOPE = { bindings: /* @__PURE__ */ new Map() };
 /**
 * Reserved by the XML Namespaces recommendation (§3): every document binds
@@ -50,5 +50,4 @@ const attachXmlNamespaceContext = (element, inheritedNamespaceScope = EMPTY_NAME
 	});
 	return namespaceScope;
 };
-//#endregion
 export { EMPTY_NAMESPACE_SCOPE, XML_NAMESPACE_URI, attachXmlNamespaceContext, resolveNamespaceUri };

package/dist/docx/xmlParser.d.ts

@@ -1,5 +1,4 @@
 import { ParseContext } from "./parseContext.js";
-//#region src/docx/xmlParser.d.ts
 /**
  * XML element tree node — drop-in replacement for the `Element` type
  * previously imported from `xml-js`. Every consumer imports this from
@@ -406,5 +405,4 @@ export declare function cloneWithXmlnsDeclarations(element: XmlElement, xmlnsDec
  * original's scope leaves resolution unchanged whether or not the clone
  * carries `xmlns` attributes of its own.
  */
-export declare function cloneElement(element: XmlElement, overrides: Partial<XmlElement>): XmlElement;
-//#endregion
+export declare function cloneElement(element: XmlElement, overrides: Partial<XmlElement>): XmlElement;

package/dist/docx/xmlParser.js

@@ -6,7 +6,7 @@ import { escapeXmlAttribute, escapeXmlText } from "@stll/docx-core";
 import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
 import { XMLParser } from "fast-xml-parser";
 import { OOXML_NS } from "@stll/docx-utils";
-//#region src/docx/xmlParser.ts
+// src/docx/xmlParser.ts
 /**
 * XML Parser Utilities for OOXML
 *
@@ -853,5 +853,4 @@ function cloneElement(element, overrides) {
 	attachXmlNamespaceContext(clone, element.namespaceScope);
 	return clone;
 }
-//#endregion
 export { NAMESPACES, OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findChildrenByNamespaceUri, findDeep, findWordprocessingChild, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffAttribute, parseOnOffChild, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument, parseXmlWithFastXmlParser, resolveAttributeNamespaceUri, selectAlternateContentBranch };

package/dist/docx/xmlResourceLimits.d.ts

@@ -1,5 +1,4 @@
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/xmlResourceLimits.d.ts
 declare const XmlResourceLimitErrorBase: TaggedErrorClass<"XmlResourceLimitError">;
 /**
  * Shared bounds for XML parts parsed by Folio.
@@ -105,5 +104,4 @@ export type XmlResourceScanResult = {
  * refusal is proportional to the limit rather than to the input.
  */
 export declare const assertXmlResourceLimits: ({ xml, limits, partPath, budget }: XmlResourceScanOptions) => XmlResourceScanResult;
-//#endregion
 export {};

package/dist/docx/xmlResourceLimits.js

@@ -1,5 +1,5 @@
 import { TaggedError } from "better-result";
-//#region src/docx/xmlResourceLimits.ts
+// src/docx/xmlResourceLimits.ts
 const MEBIBYTE = 1048576;
 const XmlResourceLimitErrorBase = TaggedError("XmlResourceLimitError");
 /**
@@ -191,5 +191,4 @@ const assertXmlResourceLimits = ({ xml, limits = FOLIO_XML_RESOURCE_LIMITS, part
 		maxDepth
 	};
 };
-//#endregion
 export { FOLIO_XML_RESOURCE_LIMITS, XmlResourceLimitError, assertXmlResourceLimits, createXmlPackageBudget, exceedsUtf8ByteLimit };

package/dist/docx/xmlSafety.d.ts

@@ -1,4 +1,2 @@
-//#region src/docx/xmlSafety.d.ts
 export type DocxXmlSafetyIssue = "doctype-forbidden" | "entity-forbidden" | "not-well-formed";
-export declare const getDocxXmlSafetyIssue: (xml: string) => DocxXmlSafetyIssue | null;
-//#endregion
+export declare const getDocxXmlSafetyIssue: (xml: string) => DocxXmlSafetyIssue | null;

package/dist/docx/xmlSafety.js

@@ -1,5 +1,5 @@
 import { XMLValidator } from "fast-xml-parser";
-//#region src/docx/xmlSafety.ts
+// src/docx/xmlSafety.ts
 const DOCTYPE_PATTERN = /<!DOCTYPE(?:\s|>)/iu;
 const BUILT_IN_ENTITIES = /* @__PURE__ */ new Set([
 	"amp",
@@ -162,5 +162,4 @@ const getDocxXmlSafetyIssue = (xml) => {
 	if (hasInvalidXmlLexicalForm(xml)) return "not-well-formed";
 	return XMLValidator.validate(xml) === true ? null : "not-well-formed";
 };
-//#endregion
 export { getDocxXmlSafetyIssue };