@stll/folio-core 0.63.1 → 0.64.1

package/dist/docx/listTemplate.js

@@ -1,5 +1,5 @@
 import { formatOoxmlCounter } from "./ooxmlCounterFormatter.js";
-//#region src/docx/listTemplate.ts
+// src/docx/listTemplate.ts
 function resolveListTemplate(options) {
 	return resolveListTemplateWithComponents(options).value;
 }
@@ -36,5 +36,4 @@ function resolveListTemplateWithComponents({ template, counters, levelFormats, f
 		components
 	};
 }
-//#endregion
 export { resolveListTemplate, resolveListTemplateWithComponents };

package/dist/docx/markupRangeMarker.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/markupRangeMarker.d.ts
 export declare const parseMarkupRangeMarker: (node: XmlElement) => document_d_exports.MarkupRangeMarker;
 export declare const parseCopyOriginMarker: (node: XmlElement) => Pick<document_d_exports.BookmarkStart, "copyOriginAncestors">;
 export declare const parseBookmarkRangeMarker: (node: XmlElement) => Omit<document_d_exports.BookmarkStart, "type">;
@@ -28,5 +27,4 @@ type BlockMoveRangeMarkerHandlers = {
   readonly moveToRangeEnd: BlockMoveRangeMarkerHandler;
 };
 export declare const BLOCK_MOVE_RANGE_MARKER_HANDLERS: BlockMoveRangeMarkerHandlers;
-//#endregion
 export {};

package/dist/docx/markupRangeMarker.js

@@ -1,6 +1,6 @@
 import { parseCopyOriginAncestors } from "./reviewResolutionProvenance.js";
 import { getAttribute, parseNumericAttribute } from "./xmlParser.js";
-//#region src/docx/markupRangeMarker.ts
+// src/docx/markupRangeMarker.ts
 /** ST_DisplacedByCustomXml. A value outside it is not a placement folio can honour. */
 const DISPLACED_BY_CUSTOM_XML = /* @__PURE__ */ new Set(["next", "prev"]);
 const parseDisplacedByCustomXml = (node) => {
@@ -74,5 +74,4 @@ const BLOCK_MOVE_RANGE_MARKER_HANDLERS = {
 		});
 	}
 };
-//#endregion
 export { BLOCK_MOVE_RANGE_MARKER_HANDLERS, parseBookmarkRangeMarker, parseCopyOriginMarker, parseMarkupRangeMarker, parseMoveBookmarkMarker };

package/dist/docx/mathToMathml.d.ts

@@ -1,5 +1,4 @@
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/mathToMathml.d.ts
 /**
  * Return the shared run size when every OMML math run explicitly carries
  * the same `w:sz`. Mixed or partially specified equations inherit surrounding
@@ -15,5 +14,4 @@ export declare function sharedMathRunFontSize(ommlXml: string): number | undefin
  * `Range.createContextualFragment`. Returns `null` if `omml` is not an
  * OMML root element or contains no convertible children.
  */
-export declare function ommlToMathml(omml: XmlElement): string | null;
-//#endregion
+export declare function ommlToMathml(omml: XmlElement): string | null;

package/dist/docx/mathToMathml.js

@@ -1,7 +1,7 @@
 import { WORDPROCESSINGML_NAMESPACE_URIS, findChildByLocalName, findChildByNamespaceUri, getAttributeByNamespaceUri, getLocalName, getNamespaceUri, parseXmlDocument } from "./xmlParser.js";
 import { assertXmlResourceLimits } from "./xmlResourceLimits.js";
 import { escapeXmlText } from "@stll/docx-core";
-//#region src/docx/mathToMathml.ts
+// src/docx/mathToMathml.ts
 /**
 * OMML → MathML conversion.
 *
@@ -419,5 +419,4 @@ function getAttrValue(el, localAttr) {
 		return String(v);
 	}
 }
-//#endregion
 export { ommlToMathml, sharedMathRunFontSize };

package/dist/docx/metadataPrivacy.d.ts

@@ -1,5 +1,4 @@
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/metadataPrivacy.d.ts
 export declare const FOLIO_DOCUMENT_METADATA_PROPERTIES: readonly ["title", "subject", "creator", "keywords", "description", "lastModifiedBy", "revision", "created", "modified"];
 export type FolioDocumentMetadataProperty = (typeof FOLIO_DOCUMENT_METADATA_PROPERTIES)[number];
 export declare const FOLIO_DOCUMENT_PRIVACY_TRANSFORMS: readonly ["remove-attribution", "remove-timestamps", "remove-descriptive-metadata"];
@@ -35,5 +34,4 @@ export declare const PRIVATE_METADATA_PROPERTIES_BY_TRANSFORM: {
 export declare const resolveFolioDocumentPrivacyTransforms: (transforms: unknown) => FolioDocumentPrivacyTransform[];
 /** Rewrite selected package metadata fields without changing other package parts. */
 export declare const rewriteDocxMetadataPrivacy: (buffer: ArrayBuffer, { transforms }: FolioDocumentPrivacyOptions) => Promise<RewriteDocxMetadataPrivacyResult>;
-//#endregion
 export {};

package/dist/docx/metadataPrivacy.js

@@ -4,7 +4,7 @@ import { elementToXml, getLocalName, parseXmlDocument } from "./xmlParser.js";
 import { TaggedError } from "better-result";
 import JSZip from "jszip";
 import { writeZipPart } from "@stll/docx-core/zip";
-//#region src/docx/metadataPrivacy.ts
+// src/docx/metadataPrivacy.ts
 const FOLIO_DOCUMENT_METADATA_PROPERTIES = Object.freeze([
 	"title",
 	"subject",
@@ -172,5 +172,4 @@ const rewriteDocxMetadataPrivacy = async (buffer, { transforms }) => {
 		}
 	};
 };
-//#endregion
 export { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentPrivacyArchiveError, InvalidFolioDocumentPrivacyOptionsError, PRIVATE_METADATA_PROPERTIES_BY_TRANSFORM, isFolioDocumentPrivacyTransform, resolveFolioDocumentPrivacyTransforms, rewriteDocxMetadataPrivacy };

package/dist/docx/metafileRaster.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/metafileRaster.d.ts
 /**
  * Extract a browser-renderable raster (PNG/JPEG) embedded inside an
  * EMF/WMF metafile.
@@ -25,5 +24,4 @@ export type ExtractedRaster = {
  */
 export declare function extractMetafileRaster(data: ArrayBuffer | Uint8Array): ExtractedRaster | null;
 /** True for EMF/WMF MIME types — the formats browsers cannot render natively. */
-export declare function isMetafileMimeType(mimeType: string | undefined): boolean;
-//#endregion
+export declare function isMetafileMimeType(mimeType: string | undefined): boolean;

package/dist/docx/metafileRaster.js

@@ -1,5 +1,5 @@
 import { decodeText } from "../utils/textEncoding.js";
-//#region src/docx/metafileRaster.ts
+// src/docx/metafileRaster.ts
 function indexOfBytes(haystack, needle, from = 0) {
 	outer: for (let i = from; i + needle.length <= haystack.length; i++) {
 		for (let j = 0; j < needle.length; j++) if (haystack[i + j] !== needle[j]) continue outer;
@@ -77,5 +77,4 @@ const METAFILE_MIME = /* @__PURE__ */ new Set([
 function isMetafileMimeType(mimeType) {
 	return !!mimeType && METAFILE_MIME.has(mimeType);
 }
-//#endregion
 export { extractMetafileRaster, isMetafileMimeType };

package/dist/docx/metafileSvg.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/metafileSvg.d.ts
 /**
  * Render a deliberately small, browser-safe EMF subset to generated SVG.
  *
@@ -7,5 +6,4 @@
  * Original EMF bytes remain the source of truth for DOCX round-trip.
  */
 /** Convert the supported filled-path EMF subset to inert generated SVG. */
-export declare function renderEmfSvg(data: ArrayBuffer | Uint8Array): string | null;
-//#endregion
+export declare function renderEmfSvg(data: ArrayBuffer | Uint8Array): string | null;

package/dist/docx/metafileSvg.js

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

package/dist/docx/metafileSvgShared.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/metafileSvgShared.d.ts
 /** Helpers shared by the fail-closed EMF and WMF SVG renderers. */
 export type MetafilePoint = {
   x: number;
@@ -23,5 +22,4 @@ type AssembleMetafileSvgOptions = {
   maxCharacters: number;
 };
 export declare const assembleMetafileSvg: ({ width, height, elements, maxCharacters }: AssembleMetafileSvgOptions) => string | null;
-//#endregion
 export {};

package/dist/docx/metafileSvgShared.js

@@ -1,4 +1,4 @@
-//#region src/docx/metafileSvgShared.ts
+// src/docx/metafileSvgShared.ts
 const transformMetafilePoint = ({ point, windowOrigin, windowExtent, viewportOrigin, viewportExtent, outputOrigin, maxCoordinate }) => {
 	if (windowExtent.x === 0 || windowExtent.y === 0) return;
 	const x = (point.x - windowOrigin.x) * viewportExtent.x / windowExtent.x + viewportOrigin.x - outputOrigin.x;
@@ -24,5 +24,4 @@ const assembleMetafileSvg = ({ width, height, elements, maxCharacters }) => {
 	const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${metafileNumberText(width)} ${metafileNumberText(height)}">${elements.join("")}</svg>`;
 	return svg.length <= maxCharacters ? svg : null;
 };
-//#endregion
 export { assembleMetafileSvg, metafileColorRefToCss, metafileNumberText, transformMetafilePoint };

package/dist/docx/modelValidation.d.ts

@@ -1,11 +1,9 @@
 import { document_d_exports } from "../types/document.js";
 import { ValidateDocumentModelIssue, ValidateDocumentModelResult } from "@stll/docx-core";
-//#region src/docx/modelValidation.d.ts
 export declare class DocxModelValidationError extends Error {
   readonly issues: ValidateDocumentModelIssue[];
   constructor(context: string, issues: ValidateDocumentModelIssue[]);
 }
 export declare const validateFolioDocumentModel: (document: document_d_exports.Document) => ValidateDocumentModelResult;
 export declare const assertValidFolioDocumentModel: (document: document_d_exports.Document, context: string) => void;
-export declare const formatDocumentModelIssues: (issues: ValidateDocumentModelIssue[]) => string[];
-//#endregion
+export declare const formatDocumentModelIssues: (issues: ValidateDocumentModelIssue[]) => string[];

package/dist/docx/modelValidation.js

@@ -1,6 +1,6 @@
 import { validateDocumentModel } from "@stll/docx-core";
 import { isCanonicallyEmptyParagraphFormatting } from "@stll/docx-core/model";
-//#region src/docx/modelValidation.ts
+// src/docx/modelValidation.ts
 var DocxModelValidationError = class extends Error {
 	issues;
 	constructor(context, issues) {
@@ -160,5 +160,4 @@ const assertValidFolioDocumentModel = (document, context) => {
 const formatDocumentModelIssues = (issues) => issues.map((issue) => {
 	return `${issue.severity === "warning" ? "DOCX model warning" : "DOCX model error"} at ${issue.path}: ${issue.message}`;
 });
-//#endregion
 export { DocxModelValidationError, assertValidFolioDocumentModel, formatDocumentModelIssues, validateFolioDocumentModel };

package/dist/docx/newImage.d.ts

@@ -1,10 +1,8 @@
 import { DrawingContent, RunContent } from "../types/content.js";
-//#region src/docx/newImage.d.ts
 /**
  * A drawing needs a new package image part only when it is model-driven.
  *
  * Raw OOXML drawings can carry previews for browser rendering. Only an explicit
  * synthetic relationship opts a detached raw picture into media registration.
  */
-export declare const isNewDataUrlDrawing: (content: RunContent) => content is DrawingContent;
-//#endregion
+export declare const isNewDataUrlDrawing: (content: RunContent) => content is DrawingContent;

package/dist/docx/newImage.js

@@ -1,4 +1,4 @@
-//#region src/docx/newImage.ts
+// src/docx/newImage.ts
 const SYNTHETIC_IMAGE_RID_PREFIX = "rId_img_";
 /**
 * A drawing needs a new package image part only when it is model-driven.
@@ -7,5 +7,4 @@ const SYNTHETIC_IMAGE_RID_PREFIX = "rId_img_";
 * synthetic relationship opts a detached raw picture into media registration.
 */
 const isNewDataUrlDrawing = (content) => content.type === "drawing" && (!content.rawXml || content.image.rId?.startsWith(SYNTHETIC_IMAGE_RID_PREFIX) === true) && content.image.src?.startsWith("data:") === true && (!content.image.rId || content.image.rId.startsWith(SYNTHETIC_IMAGE_RID_PREFIX));
-//#endregion
 export { isNewDataUrlDrawing };

package/dist/docx/nonVisualDrawingProps.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/nonVisualDrawingProps.d.ts
 /**
  * Read `@name`, `@descr` and `@title` off a `CT_NonVisualDrawingProps` element.
  *

package/dist/docx/nonVisualDrawingProps.js

@@ -1,6 +1,6 @@
 import { getAttribute } from "./xmlParser.js";
 import { escapeXmlAttribute } from "@stll/docx-core";
-//#region src/docx/nonVisualDrawingProps.ts
+// src/docx/nonVisualDrawingProps.ts
 /**
 * `CT_NonVisualDrawingProps` (`wp:docPr`, `wps:cNvPr`, `pic:cNvPr`) carries the
 * three authored strings every drawing object has: its name, its alt text
@@ -42,5 +42,4 @@ const serializeNonVisualDrawingNames = (names) => {
 	const title = names.title === void 0 ? "" : ` title="${escapeXmlAttribute(names.title)}"`;
 	return ` name="${escapeXmlAttribute(names.name ?? "")}"${descr}${title}`;
 };
-//#endregion
 export { parseNonVisualDrawingNames, serializeNonVisualDrawingNames };

package/dist/docx/normalizeBaseDirection.d.ts

@@ -1,10 +1,8 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/normalizeBaseDirection.d.ts
 /**
  * Return a copy of `doc` with `bidi` filled in for undecided RTL-led body
  * paragraphs (including those nested in tables and block content controls).
  * A paragraph whose direction is set directly OR via its style / doc defaults
  * is left untouched.
  */
-export declare const normalizeBaseDirection: (doc: document_d_exports.Document) => document_d_exports.Document;
-//#endregion
+export declare const normalizeBaseDirection: (doc: document_d_exports.Document) => document_d_exports.Document;

package/dist/docx/normalizeBaseDirection.js

@@ -1,7 +1,7 @@
 import { createStyleResolver } from "../prosemirror/styles/styleResolver.js";
 import { detectBaseDirection } from "../utils/baseDirection.js";
 import { cloneParagraphWithoutPropertySource } from "./paragraphPropertySource.js";
-//#region src/docx/normalizeBaseDirection.ts
+// src/docx/normalizeBaseDirection.ts
 const runText = (run) => {
 	let text = "";
 	for (const piece of run.content) if (piece.type === "text") text += piece.text;
@@ -95,5 +95,4 @@ const normalizeBaseDirection = (doc) => {
 		}
 	};
 };
-//#endregion
 export { normalizeBaseDirection };

package/dist/docx/noteIds.d.ts

@@ -1,8 +1,6 @@
-//#region src/docx/noteIds.d.ts
 /**
  * The next free endnote id among `existingIds`, a document's endnotes. Ids are
  * unique per document, so the allocator lives for one call: the result
  * depends only on the document, never on what other documents minted.
  */
-export declare const mintEndnoteId: (existingIds: Iterable<number>) => number;
-//#endregion
+export declare const mintEndnoteId: (existingIds: Iterable<number>) => number;

package/dist/docx/noteIds.js

@@ -1,5 +1,5 @@
 import { createNumericIdAllocator } from "./numericIdAllocator.js";
-//#region src/docx/noteIds.ts
+// src/docx/noteIds.ts
 /**
 * The next free endnote id among `existingIds`, a document's endnotes. Ids are
 * unique per document, so the allocator lives for one call: the result
@@ -13,5 +13,4 @@ const mintEndnoteId = (existingIds) => {
 	allocator.reserve(existingIds);
 	return allocator.next();
 };
-//#endregion
 export { mintEndnoteId };

package/dist/docx/notePropertiesParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/notePropertiesParser.d.ts
 /**
  * Parse footnote properties from w:footnotePr element
  * (Can appear in w:sectPr or w:settings)
@@ -10,5 +9,4 @@ export declare function parseFootnoteProperties(element: XmlElement | null): doc
  * Parse endnote properties from w:endnotePr element
  * (Can appear in w:sectPr or w:settings)
  */
-export declare function parseEndnoteProperties(element: XmlElement | null): document_d_exports.EndnoteProperties;
-//#endregion
+export declare function parseEndnoteProperties(element: XmlElement | null): document_d_exports.EndnoteProperties;

package/dist/docx/notePropertiesParser.js

@@ -1,6 +1,6 @@
 import { NumberFormatSchema, narrowEnum } from "./parserEnums.js";
 import { findChild, getAttribute, parseNumericAttribute } from "./xmlParser.js";
-//#region src/docx/notePropertiesParser.ts
+// src/docx/notePropertiesParser.ts
 function parseNumberFormat(numFmtAttr) {
 	return narrowEnum(numFmtAttr, NumberFormatSchema);
 }
@@ -103,5 +103,4 @@ function parseEndnoteProperties(element) {
 	}
 	return props;
 }
-//#endregion
 export { parseEndnoteProperties, parseFootnoteProperties };

package/dist/docx/noteReferenceMark.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/noteReferenceMark.d.ts
 type NoteKind = "footnote" | "endnote";
 /** The run carrying a note's in-note reference mark, in the note reference style. */
 export declare const noteReferenceMarkRun: (kind: NoteKind) => document_d_exports.Run;
@@ -13,5 +12,4 @@ export declare const withNoteReferenceMark: (kind: NoteKind, content: readonly d
 /** A new note, as an editor adds one: its content led by its own reference mark. */
 export declare function createNote(kind: "footnote", id: number, content: readonly document_d_exports.BlockContent[]): document_d_exports.Footnote;
 export declare function createNote(kind: "endnote", id: number, content: readonly document_d_exports.BlockContent[]): document_d_exports.Endnote;
-//#endregion
 export {};

package/dist/docx/noteReferenceMark.js

@@ -1,6 +1,6 @@
 import { cloneParagraphWithPropertySource } from "./paragraphPropertySource.js";
 import { visitDocxParagraphs, visitParagraphRuns } from "./paragraphTraversal.js";
-//#region src/docx/noteReferenceMark.ts
+// src/docx/noteReferenceMark.ts
 /** The run carrying a note's in-note reference mark, in the note reference style. */
 const noteReferenceMarkRun = (kind) => ({
 	type: "run",
@@ -45,5 +45,4 @@ function createNote(kind, id, content) {
 		content: withNoteReferenceMark(kind, content)
 	};
 }
-//#endregion
 export { createNote, hasNoteReferenceMark, noteReferenceMarkRun, withNoteReferenceMark };

package/dist/docx/noteReferenceStyles.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/noteReferenceStyles.d.ts
 /** The id `commentSerializer` and `paragraphSerializer` write. */
 export declare const COMMENT_REFERENCE_STYLE_ID = "CommentReference";
 /** The ids `noteSerializer` writes for the two note kinds. */
@@ -24,5 +23,4 @@ export declare const noteReferenceNeeds: (pkg: {
  * caller owns the document, and a document that already defines the style
  * (under any id folio recognises) keeps its own.
  */
-export declare const missingNoteReferenceStyles: (styles: document_d_exports.StyleDefinitions | undefined, needs: NoteReferenceNeeds) => document_d_exports.Style[];
-//#endregion
+export declare const missingNoteReferenceStyles: (styles: document_d_exports.StyleDefinitions | undefined, needs: NoteReferenceNeeds) => document_d_exports.Style[];

package/dist/docx/noteReferenceStyles.js

@@ -1,5 +1,5 @@
 import { BUILT_IN_STYLE_NAME } from "./builtInStyles.js";
-//#region src/docx/noteReferenceStyles.ts
+// src/docx/noteReferenceStyles.ts
 /** The id `commentSerializer` and `paragraphSerializer` write. */
 const COMMENT_REFERENCE_STYLE_ID = "CommentReference";
 /** The ids `noteSerializer` writes for the two note kinds. */
@@ -53,5 +53,4 @@ const missingNoteReferenceStyles = (styles, needs) => {
 	}
 	return missing;
 };
-//#endregion
 export { COMMENT_REFERENCE_STYLE_ID, ENDNOTE_REFERENCE_STYLE_ID, FOOTNOTE_REFERENCE_STYLE_ID, missingNoteReferenceStyles, noteReferenceNeeds };

package/dist/docx/numberingIds.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/numberingIds.d.ts
 type NumberingKind = "num" | "abstract";
 type MintNumberingIdOptions = {
   kind: NumberingKind;
@@ -10,5 +9,4 @@ export declare const createNumberingIdAllocator: (kind: NumberingKind, existingI
   next: () => number;
 };
 export declare const mintNumberingId: ({ kind, existingIds }: MintNumberingIdOptions) => number;
-//#endregion
 export {};

package/dist/docx/numberingIds.js

@@ -1,5 +1,5 @@
 import { createNumericIdAllocator } from "./numericIdAllocator.js";
-//#region src/docx/numberingIds.ts
+// src/docx/numberingIds.ts
 /** Independent offline packages can allocate deterministically without retaining realm state. */
 const createNumberingIdAllocator = (kind, existingIds) => {
 	const allocator = createNumericIdAllocator({
@@ -12,5 +12,4 @@ const createNumberingIdAllocator = (kind, existingIds) => {
 const mintNumberingId = ({ kind, existingIds }) => {
 	return createNumberingIdAllocator(kind, existingIds).next();
 };
-//#endregion
 export { createNumberingIdAllocator, mintNumberingId };

package/dist/docx/numberingParser.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { formatOoxmlCounter, padDecimal } from "./ooxmlCounterFormatter.js";
 import { numberingLevelHasMarkerSlot } from "@stll/docx-core/model";
-//#region src/docx/numberingParser.d.ts
 /**
  * Map of rId to numbering definitions
  */
@@ -84,5 +83,4 @@ export declare function getBulletCharacter(level: document_d_exports.ListLevel):
 export declare function isBulletLevel(level: document_d_exports.ListLevel): boolean;
 /** Whether a numbering definition uses a bullet marker rather than a numeric or hidden one. */
 export declare const numberingLevelUsesBulletMarker: (level: Pick<document_d_exports.ListLevel, "numFmt"> | null | undefined) => boolean;
-//#endregion
 export { formatOoxmlCounter as formatNumber, numberingLevelHasMarkerSlot, padDecimal };

package/dist/docx/numberingParser.js

@@ -7,7 +7,7 @@ import { LevelSuffixSchema, NumberFormatSchema, ParagraphAlignmentSchema, narrow
 import { RUN_PROPERTY_OWNERS, parseRunProperties } from "./runParser.js";
 import { findChild, getAttribute, parseBooleanElement, parseNumericAttribute, parseOnOffAttribute, parseXmlDocument } from "./xmlParser.js";
 import { numberingLevelHasMarkerSlot, resolveNumberingLevel } from "@stll/docx-core/model";
-//#region src/docx/numberingParser.ts
+// src/docx/numberingParser.ts
 /**
 * Numbering/List Parser for DOCX
 *
@@ -516,5 +516,4 @@ function isBulletLevel(level) {
 }
 /** Whether a numbering definition uses a bullet marker rather than a numeric or hidden one. */
 const numberingLevelUsesBulletMarker = (level) => level?.numFmt === "bullet";
-//#endregion
 export { computeListRendering, counterFormatOf, createNumberingMap, customNumberFormatPadWidth, formatOoxmlCounter as formatNumber, getBulletCharacter, getCachedNumberingMap, isBulletLevel, markerAlignmentForLevel, markerFormattingFromLevel, numberingLevelHasMarkerSlot, numberingLevelUsesBulletMarker, padDecimal, parseNumbering, renderListMarker };

package/dist/docx/numberingReference.d.ts

@@ -1,6 +1,5 @@
 import { XmlElement } from "./xmlParser.js";
 import { NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, ParagraphNumberingOverride, ParagraphNumberingOverride as ParagraphNumberingOverride$1, ParagraphNumberingReference, ParagraphNumberingSlots, ResolvedParagraphNumbering, isNumberingReference, mergeParagraphNumbering, paragraphNumberingFromSlots, paragraphNumberingLevel, paragraphNumberingReference, paragraphNumberingReferenceId, paragraphNumberingSlots, resolveParagraphNumbering, sameEffectiveParagraphNumbering, sameStatedParagraphNumbering } from "@stll/docx-core/model";
-//#region src/docx/numberingReference.d.ts
 /**
  * What a `<w:numPr>` states: absent (the tier states nothing), the reserved
  * cancellation, a reference, or a level alone.
@@ -10,5 +9,4 @@ import { NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, ParagraphNumberingOverride
  * travels as captured markup.
  */
 export declare const readParagraphNumbering: (numPr: XmlElement | null | undefined) => ParagraphNumberingOverride$1 | undefined;
-//#endregion
 export { NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, type ParagraphNumberingOverride, type ParagraphNumberingReference, type ParagraphNumberingSlots, type ResolvedParagraphNumbering, isNumberingReference, mergeParagraphNumbering, paragraphNumberingFromSlots, paragraphNumberingLevel, paragraphNumberingReference, paragraphNumberingReferenceId, paragraphNumberingSlots, resolveParagraphNumbering, sameEffectiveParagraphNumbering, sameStatedParagraphNumbering };

package/dist/docx/numberingReference.js

@@ -1,6 +1,6 @@
 import { findChild, parseNumberingLevelAttribute, parseNumericAttribute } from "./xmlParser.js";
 import { NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, isNumberingReference, mergeParagraphNumbering, paragraphNumberingFromSlots, paragraphNumberingFromSlots as paragraphNumberingFromSlots$1, paragraphNumberingLevel, paragraphNumberingReference, paragraphNumberingReferenceId, paragraphNumberingSlots, resolveParagraphNumbering, sameEffectiveParagraphNumbering, sameStatedParagraphNumbering } from "@stll/docx-core/model";
-//#region src/docx/numberingReference.ts
+// src/docx/numberingReference.ts
 /**
 * What a `<w:numPr>` states: absent (the tier states nothing), the reserved
 * cancellation, a reference, or a level alone.
@@ -18,5 +18,4 @@ const readParagraphNumbering = (numPr) => {
 		ilvl: ilvlElement ? parseNumberingLevelAttribute(ilvlElement) : void 0
 	});
 };
-//#endregion
 export { NO_NUMBERING_NUM_ID, NO_PARAGRAPH_NUMBERING, isNumberingReference, mergeParagraphNumbering, paragraphNumberingFromSlots, paragraphNumberingLevel, paragraphNumberingReference, paragraphNumberingReferenceId, paragraphNumberingSlots, readParagraphNumbering, resolveParagraphNumbering, sameEffectiveParagraphNumbering, sameStatedParagraphNumbering };

package/dist/docx/numberingReferenceNormalization.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
-//#region src/docx/numberingReferenceNormalization.d.ts
 /** The codes this normalisation is reported under, owned here, not at the caller. */
 export declare const UNNUMBERED_PARAGRAPH_WARNING: "unnumbered-paragraph";
 export declare const UNNUMBERED_STYLE_WARNING: "unnumbered-style";
@@ -25,5 +24,4 @@ type NormalizeStyleNumberingReferencesResult = {
   unnumberedStyleIds: string[];
 };
 export declare const normalizeStyleNumberingReferences: ({ styles, numbering }: NormalizeStyleNumberingReferencesInput) => NormalizeStyleNumberingReferencesResult;
-//#endregion
 export {};

package/dist/docx/numberingReferenceNormalization.js

@@ -1,7 +1,7 @@
 import { NO_PARAGRAPH_NUMBERING as NO_PARAGRAPH_NUMBERING$1, paragraphNumberingReferenceId } from "./numberingReference.js";
 import { visitDocxParagraphs } from "./paragraphTraversal.js";
 import { PARSE_WARNING_CODES, numberingInstanceResolves } from "@stll/docx-core/model";
-//#region src/docx/numberingReferenceNormalization.ts
+// src/docx/numberingReferenceNormalization.ts
 /**
 * Parse-boundary tolerance for `w:numPr` numbering references.
 *
@@ -57,5 +57,4 @@ const normalizeStyleNumberingReferences = ({ styles, numbering }) => {
 	}
 	return { unnumberedStyleIds };
 };
-//#endregion
 export { UNNUMBERED_PARAGRAPH_WARNING, UNNUMBERED_STYLE_WARNING, normalizeNumberingReferences, normalizeStyleNumberingReferences };

package/dist/docx/numericIdAllocator.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/numericIdAllocator.d.ts
 type NumericIdAllocatorOptions = {
   space: string;
   firstId: 0 | 1;
@@ -8,5 +7,4 @@ export declare const createNumericIdAllocator: ({ space, firstId }: NumericIdAll
   reserve: (ids: Iterable<number>) => void;
   next: () => number;
 };
-//#endregion
 export {};

package/dist/docx/numericIdAllocator.js

@@ -1,6 +1,6 @@
 import { TaggedError } from "better-result";
 import { MAX_REVISION_ID } from "@stll/docx-core/model";
-//#region src/docx/numericIdAllocator.ts
+// src/docx/numericIdAllocator.ts
 const OoxmlIdSpaceExhaustedErrorBase = TaggedError("OoxmlIdSpaceExhaustedError");
 var OoxmlIdSpaceExhaustedError = class extends OoxmlIdSpaceExhaustedErrorBase {};
 /** Each OOXML id space owns one instance, retaining loaded and minted ids through rollover. */
@@ -30,5 +30,4 @@ const createNumericIdAllocator = ({ space, firstId }) => {
 		}
 	};
 };
-//#endregion
 export { createNumericIdAllocator };

package/dist/docx/numericIdNormalization.d.ts

@@ -1,6 +1,5 @@
 import { RawDocxContent } from "./unzip.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/numericIdNormalization.d.ts
 type NumericIdNormalizationOptions = {
   onParsedDocument?: (document: XmlElement) => void;
 };
@@ -12,5 +11,4 @@ type NumericIdNormalizationOptions = {
 export declare const normalizeImportedNumericIds: (parts: ReadonlyMap<string, string>, options?: NumericIdNormalizationOptions) => ReadonlyMap<string, string>;
 /** Parser boundary: all captures and selective-save bytes see the same identities. */
 export declare const normalizeRawDocxNumericIds: (raw: RawDocxContent) => Promise<XmlElement | undefined>;
-//#endregion
 export {};

package/dist/docx/numericIdNormalization.js

@@ -5,7 +5,7 @@ import { getLocalName, getNamespaceUri, resolveAttributeNamespaceUri } from "./x
 import { XmlResourceLimitError } from "./xmlResourceLimits.js";
 import { panic } from "better-result";
 import { assertValidOoxmlNumericId, isOoxmlNumericIdAttributeName, isValidOoxmlNumericId, mayContainInvalidOoxmlNumericIds, mayContainOoxmlNumericIds, ooxmlNumericIdDomain } from "@stll/docx-core";
-//#region src/docx/numericIdNormalization.ts
+// src/docx/numericIdNormalization.ts
 const identityKey = (value) => {
 	const spelling = String(value).trim();
 	if (!/^[+-]?\d+$/u.test(spelling)) return spelling;
@@ -169,5 +169,4 @@ const normalizeRawDocxNumericIds = async (raw) => {
 	await replaceRawDocxXmlParts(raw, normalized);
 	return documentTree;
 };
-//#endregion
 export { normalizeImportedNumericIds, normalizeRawDocxNumericIds };

package/dist/docx/ooxmlCounterFormatter.d.ts

@@ -1,7 +1,5 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/ooxmlCounterFormatter.d.ts
 /** Zero-pad a counter to `width` digits (the `decimalZero` family). */
 export declare const padDecimal: (value: number, width: number) => string;
 /** Format one OOXML numbering counter using Microsoft Word display semantics. */
-export declare const formatOoxmlCounter: (value: number, format: document_d_exports.CounterFormat | undefined) => string;
-//#endregion
+export declare const formatOoxmlCounter: (value: number, format: document_d_exports.CounterFormat | undefined) => string;

package/dist/docx/ooxmlCounterFormatter.js

@@ -1,4 +1,4 @@
-//#region src/docx/ooxmlCounterFormatter.ts
+// src/docx/ooxmlCounterFormatter.ts
 const ROMAN_PAIRS = [
 	[1e3, "M"],
 	[900, "CM"],
@@ -133,5 +133,4 @@ const formatOoxmlCounter = (value, format) => {
 		default: return String(value);
 	}
 };
-//#endregion
 export { formatOoxmlCounter, padDecimal };

package/dist/docx/opaqueCarrier.d.ts

@@ -1,6 +1,4 @@
-//#region src/docx/opaqueCarrier.d.ts
 export declare const OPAQUE_REVISION_CARRIER_READER_DIAGNOSTIC = "[Unsupported block-level tracked-change content]";
 export declare const opaqueRevisionCarrierName: (xml: string) => string | undefined;
 export declare const countOpaqueRevisionWrappers: (xml: string) => number;
-export declare const isOpaqueNestedRowMarkup: (xml: string) => boolean;
-//#endregion
+export declare const isOpaqueNestedRowMarkup: (xml: string) => boolean;

package/dist/docx/opaqueCarrier.js

@@ -1,5 +1,5 @@
 import { OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, getChildElements, getLocalName, parseXml } from "./xmlParser.js";
-//#region src/docx/opaqueCarrier.ts
+// src/docx/opaqueCarrier.ts
 const OPAQUE_REVISION_CARRIER_READER_DIAGNOSTIC = "[Unsupported block-level tracked-change content]";
 const REVISION_WRAPPERS = /* @__PURE__ */ new Set([
 	"ins",
@@ -34,5 +34,4 @@ const isOpaqueNestedRowMarkup = (xml) => {
 	const element = getChildElements(parseXml(xml, OOXML_NAMESPACE_SCOPE)).at(0);
 	return element !== void 0 && getLocalName(element.name) === "tr" && WORDPROCESSINGML_NAMESPACE_URIS.has(element.namespaceUri ?? "");
 };
-//#endregion
 export { OPAQUE_REVISION_CARRIER_READER_DIAGNOSTIC, countOpaqueRevisionWrappers, isOpaqueNestedRowMarkup, opaqueRevisionCarrierName };

package/dist/docx/packageParts.d.ts

@@ -1,5 +1,4 @@
 import JSZip from "jszip";
-//#region src/docx/packageParts.d.ts
 /** Resolve an internal URI reference once, before comparing it with ZIP entries. */
 export declare const resolvePackageRelationshipTarget: (target: string, relsPath: string) => string | undefined;
 /**
@@ -76,5 +75,4 @@ export type PackageIntegrityReport = {
  * or a corpus-gate invariant: one pass over the `.rels` parts building an id
  * census, one pass over the XML parts checking references against it.
  */
-export declare const checkPackageIntegrity: (zip: JSZip) => Promise<PackageIntegrityReport>;
-//#endregion
+export declare const checkPackageIntegrity: (zip: JSZip) => Promise<PackageIntegrityReport>;