@stll/folio-core 0.64.0 → 0.65.0

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 };

package/dist/export-pdf.d.ts

@@ -5,7 +5,6 @@ import { HeadlessLayoutGap } from "./headless-layout.js";
 import { PdfSubstitution } from "./pdf/fonts.js";
 import { PdfUnencodable } from "./pdf/writePdf.js";
 import { Result, TaggedErrorClass } from "better-result";
-//#region src/export-pdf.d.ts
 declare const ExportPdfErrorBase: TaggedErrorClass<"ExportPdfError">;
 export declare class ExportPdfError extends ExportPdfErrorBase<{
   message: string;
@@ -72,5 +71,4 @@ export type WriteDisplayListPdfResult = Pick<ExportDocxToPdfResult, "bytes" | "p
  * layout measured with.
  */
 export declare const writeDisplayListPdf: (list: DisplayList, options: WriteDisplayListPdfOptions) => Promise<Result<WriteDisplayListPdfResult, ExportPdfError>>;
-//#endregion
 export {};

package/dist/export-pdf.js

@@ -7,7 +7,7 @@ import { getMeasureProvider, setMeasureProvider } from "./layout-engine/measure/
 import { writePdf } from "./pdf/writePdf.js";
 import { Result, TaggedError } from "better-result";
 import { survivingComments } from "@stll/docx-core/ops";
-//#region src/export-pdf.ts
+// src/export-pdf.ts
 /**
 * `.docx` to PDF, with no browser and no second painter.
 *
@@ -129,5 +129,4 @@ const buildWithHeadlessProvider = async (input, options) => {
 		measurementSubstitutions: headless.substitutions()
 	});
 };
-//#endregion
 export { ExportPdfError, buildDocxDisplayList, exportDocxToPdf, writeDisplayListPdf };

package/dist/fields/bookmarkPages.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock, Page } from "../layout-engine/types.js";
-//#region src/fields/bookmarkPages.d.ts
 /**
  * Map each bookmark name to the 1-indexed page its anchoring paragraph lands on,
  * for PAGEREF resolution. Computed as a post-pass over a finished layout: walk
@@ -7,5 +6,4 @@ import { FlowBlock, Page } from "../layout-engine/types.js";
  * splits across pages takes the first (lowest) page it appears on, matching how
  * Word resolves a PAGEREF to the start of the bookmark.
  */
-export declare function buildBookmarkPageMap(pages: readonly Page[], blocks: readonly FlowBlock[]): Map<string, number>;
-//#endregion
+export declare function buildBookmarkPageMap(pages: readonly Page[], blocks: readonly FlowBlock[]): Map<string, number>;

package/dist/fields/bookmarkPages.js

@@ -1,4 +1,4 @@
-//#region src/fields/bookmarkPages.ts
+// src/fields/bookmarkPages.ts
 /**
 * Map each bookmark name to the 1-indexed page its anchoring paragraph lands on,
 * for PAGEREF resolution. Computed as a post-pass over a finished layout: walk
@@ -62,5 +62,4 @@ function fragmentContainsAnchor(fragment, anchor) {
 function assignBookmarkPage(pageByBookmark, names, pageNumber) {
 	for (const name of names) if (!pageByBookmark.has(name)) pageByBookmark.set(name, pageNumber);
 }
-//#endregion
 export { buildBookmarkPageMap };

package/dist/fields/bookmarkText.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock } from "../layout-engine/types.js";
-//#region src/fields/bookmarkText.d.ts
 type BookmarkTextInputs = {
   fieldValues?: ReadonlyMap<number, string>;
   seqValues?: ReadonlyMap<number, number>;
@@ -11,5 +10,4 @@ type BookmarkTextInputs = {
  * order, independent of layout. First paragraph carrying a name wins.
  */
 export declare function buildBookmarkText(blocks: readonly FlowBlock[], inputs?: BookmarkTextInputs): Map<string, string>;
-//#endregion
 export {};

package/dist/fields/bookmarkText.js

@@ -1,6 +1,6 @@
 import { parseFieldInstruction } from "../docx/fieldParser.js";
 import { evaluateField } from "./evaluateField.js";
-//#region src/fields/bookmarkText.ts
+// src/fields/bookmarkText.ts
 const EMPTY_STRING_NUMBER = /* @__PURE__ */ new Map();
 const EMPTY_STRING_STRING = /* @__PURE__ */ new Map();
 const EMPTY_NUMBER_NUMBER = /* @__PURE__ */ new Map();
@@ -58,5 +58,4 @@ function visibleListMarker(block) {
 	if (!normalized) return "";
 	return block.attrs?.listMarkerSuffix === "nothing" ? normalized : `${normalized} `;
 }
-//#endregion
 export { buildBookmarkText };

package/dist/fields/evaluateField.d.ts

@@ -1,6 +1,5 @@
 import { ParsedFieldInstruction } from "../docx/fieldParser.js";
 import { FieldContext } from "./fieldContext.js";
-//#region src/fields/evaluateField.d.ts
 type EvaluateFieldOptions = {
   /** Shown for unsupported field types and unresolved references. */
   fallback?: string;
@@ -21,5 +20,4 @@ export declare function evaluateField(parsed: ParsedFieldInstruction, ctx: Field
 /** Parse `instruction` then evaluate it; convenience for callers holding the
  *  raw instruction string rather than a pre-parsed instruction. */
 export declare function evaluateFieldInstruction(instruction: string, ctx: FieldContext, options?: EvaluateFieldOptions): string;
-//#endregion
 export {};

package/dist/fields/evaluateField.js

@@ -1,5 +1,5 @@
 import { computePageNumber, formatDate, parseFieldInstruction } from "../docx/fieldParser.js";
-//#region src/fields/evaluateField.ts
+// src/fields/evaluateField.ts
 /** The `\@` date picture, or undefined. Unlike the general format switch, this
 *  must NOT match `\*` (e.g. `\* MERGEFORMAT`), which is not a date format. */
 function dateFormatSwitch(parsed) {
@@ -73,5 +73,4 @@ function evaluateField(parsed, ctx, options = {}) {
 function evaluateFieldInstruction(instruction, ctx, options = {}) {
 	return evaluateField(parseFieldInstruction(instruction), ctx, options);
 }
-//#endregion
 export { evaluateField, evaluateFieldInstruction };

package/dist/fields/fieldContext.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/fields/fieldContext.d.ts
 /**
  * Resolution context for evaluating dynamic DOCX fields against a laid-out
  * document. Built once per layout pass (see the field-resolution pass) and
@@ -25,5 +24,4 @@ export type FieldContext = {
   seqValues: ReadonlyMap<number, number>;
   /** Clock for DATE/TIME-family fields; passed in so evaluation stays pure. */
   now: Date;
-};
-//#endregion
+};

package/dist/fields/resolveFieldValues.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock, Page } from "../layout-engine/types.js";
-//#region src/fields/resolveFieldValues.d.ts
 /** Layout-derived inputs shared by every field, regardless of its position. */
 export type SharedFieldInputs = {
   totalPages: number;
@@ -40,5 +39,4 @@ export declare function resolveFieldValues(blocks: readonly FlowBlock[], pages:
  */
 export declare function buildHeaderFooterFieldValues(blocks: readonly FlowBlock[], pageCount: number, now: Date, inputs?: Partial<HeaderFooterFieldInputs>): Map<number, string>;
 /** Whether two resolved-value maps are identical, for loop convergence. */
-export declare function fieldValuesEqual(a: ReadonlyMap<number, string>, b: ReadonlyMap<number, string>): boolean;
-//#endregion
+export declare function fieldValuesEqual(a: ReadonlyMap<number, string>, b: ReadonlyMap<number, string>): boolean;

package/dist/fields/resolveFieldValues.js

@@ -1,6 +1,6 @@
 import { computePageNumber, getFormatSwitch, parseFieldInstruction } from "../docx/fieldParser.js";
 import { evaluateField } from "./evaluateField.js";
-//#region src/fields/resolveFieldValues.ts
+// src/fields/resolveFieldValues.ts
 /**
 * Resolve every field run to its display value against a finished layout, keyed
 * by the run's `pmStart`. Each field is evaluated for the page its top-level
@@ -201,5 +201,4 @@ function collectFieldRuns(block, out) {
 	} else if (block.kind === "table") for (const row of block.rows) for (const cell of row.cells) for (const cellBlock of cell.blocks) collectFieldRuns(cellBlock, out);
 	else if (block.kind === "textBox") for (const child of block.content) collectFieldRuns(child, out);
 }
-//#endregion
 export { buildHeaderFooterFieldValues, fieldValuesEqual, resolveFieldValues };

package/dist/fields/sectionPageCounts.d.ts

@@ -1,9 +1,7 @@
 import { Page } from "../layout-engine/types.js";
-//#region src/fields/sectionPageCounts.d.ts
 /**
  * Count how many pages belong to each section (by `Page.sectionIndex`, defaulting
  * to 0 for single-section documents), for resolving SECTIONPAGES. A field on a
  * page reads the count for that page's section.
  */
-export declare function buildSectionPageCounts(pages: readonly Page[]): Map<number, number>;
-//#endregion
+export declare function buildSectionPageCounts(pages: readonly Page[]): Map<number, number>;

package/dist/fields/sectionPageCounts.js

@@ -1,4 +1,4 @@
-//#region src/fields/sectionPageCounts.ts
+// src/fields/sectionPageCounts.ts
 /**
 * Count how many pages belong to each section (by `Page.sectionIndex`, defaulting
 * to 0 for single-section documents), for resolving SECTIONPAGES. A field on a
@@ -12,5 +12,4 @@ function buildSectionPageCounts(pages) {
 	}
 	return counts;
 }
-//#endregion
 export { buildSectionPageCounts };

package/dist/fields/seqValues.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock } from "../layout-engine/types.js";
-//#region src/fields/seqValues.d.ts
 /**
  * Assign each SEQ field instance its sequence number in document order, keyed by
  * the field run's `pmStart`. SEQ counters are per identifier (the field
@@ -8,5 +7,4 @@ import { FlowBlock } from "../layout-engine/types.js";
  * advancing); every other SEQ advances its counter by one. Independent of
  * pagination, so it runs once per document, not per layout pass.
  */
-export declare function buildSeqValues(blocks: readonly FlowBlock[]): Map<number, number>;
-//#endregion
+export declare function buildSeqValues(blocks: readonly FlowBlock[]): Map<number, number>;

package/dist/fields/seqValues.js

@@ -1,5 +1,5 @@
 import { parseFieldInstruction } from "../docx/fieldParser.js";
-//#region src/fields/seqValues.ts
+// src/fields/seqValues.ts
 /**
 * Assign each SEQ field instance its sequence number in document order, keyed by
 * the field run's `pmStart`. SEQ counters are per identifier (the field
@@ -32,5 +32,4 @@ function walkBlocks(blocks, counters, values) {
 	else if (block.kind === "table") for (const row of block.rows) for (const cell of row.cells) walkBlocks(cell.blocks, counters, values);
 	else if (block.kind === "textBox") walkBlocks(block.content, counters, values);
 }
-//#endregion
 export { buildSeqValues };

package/dist/fonts/FontFaceLifecycle.d.ts

@@ -1,5 +1,4 @@
 import { Subscribable } from "../managers/Subscribable.js";
-//#region src/fonts/FontFaceLifecycle.d.ts
 export declare class FontFaceLifecycle<Face> extends Subscribable<number> {
   private readonly remove;
   private state;
@@ -8,5 +7,4 @@ export declare class FontFaceLifecycle<Face> extends Subscribable<number> {
   clear(): void;
   destroy(): void;
   private requireActive;
-}
-//#endregion
+}

package/dist/fonts/FontFaceLifecycle.js

@@ -1,6 +1,6 @@
 import { Subscribable } from "../managers/Subscribable.js";
 import { panic } from "better-result";
-//#region src/fonts/FontFaceLifecycle.ts
+// src/fonts/FontFaceLifecycle.ts
 var FontFaceLifecycle = class extends Subscribable {
 	remove;
 	state = {
@@ -52,5 +52,4 @@ var FontFaceLifecycle = class extends Subscribable {
 		return current;
 	}
 };
-//#endregion
 export { FontFaceLifecycle };

package/dist/fonts/documentFontFacts.d.ts

@@ -1,5 +1,4 @@
 import { FontInfo, FontTable } from "@stll/docx-core/model";
-//#region src/fonts/documentFontFacts.d.ts
 type DocumentFontInfo = Readonly<Pick<FontInfo, "family" | "pitch"> & {
   charset?: Readonly<NonNullable<FontInfo["charset"]>>;
 }>;
@@ -13,5 +12,4 @@ declare class OwnedDocumentFontFacts {
 export declare const buildDocumentFontFacts: (fontTable: FontTable | null | undefined) => DocumentFontFacts | undefined;
 export declare const documentFontFactsCacheIdentity: (facts: DocumentFontFacts | undefined) => string | undefined;
 export declare const documentFontInfoOf: (fontName: string, facts: DocumentFontFacts | undefined) => DocumentFontInfo | undefined;
-//#endregion
 export {};

package/dist/fonts/documentFontFacts.js

@@ -1,6 +1,6 @@
 import { boundedContentIdentity } from "../utils/boundedContentIdentity.js";
 import { canonicalJson } from "../utils/canonicalJson.js";
-//#region src/fonts/documentFontFacts.ts
+// src/fonts/documentFontFacts.ts
 const normalizeFontName = (name) => name.trim().toLowerCase();
 var OwnedDocumentFontFacts = class {
 	#fontsByName;
@@ -37,5 +37,4 @@ const cacheIdentityForEntries = (facts) => {
 };
 const documentFontFactsCacheIdentity = (facts) => facts?.cacheIdentity;
 const documentFontInfoOf = (fontName, facts) => facts?.fontInfoOf(fontName);
-//#endregion
 export { buildDocumentFontFacts, documentFontFactsCacheIdentity, documentFontInfoOf };

package/dist/fonts/embeddedFontFingerprint.d.ts

@@ -1,4 +1,2 @@
-//#region src/fonts/embeddedFontFingerprint.d.ts
 /** Callers replace owned maps on font changes; mutating a published map is unsupported. */
-export declare const embeddedFontFingerprint: (families: ReadonlyMap<string, string>) => string;
-//#endregion
+export declare const embeddedFontFingerprint: (families: ReadonlyMap<string, string>) => string;

package/dist/fonts/embeddedFontFingerprint.js

@@ -1,5 +1,5 @@
 import { boundedContentIdentity } from "../utils/boundedContentIdentity.js";
-//#region src/fonts/embeddedFontFingerprint.ts
+// src/fonts/embeddedFontFingerprint.ts
 /** Immutable editor-owned lookups reuse cache-local identities without retaining disposed editors. */
 const fingerprints = /* @__PURE__ */ new WeakMap();
 /** Callers replace owned maps on font changes; mutating a published map is unsupported. */
@@ -15,5 +15,4 @@ const embeddedFontFingerprint = (families) => {
 	fingerprints.set(families, fingerprint);
 	return fingerprint;
 };
-//#endregion
 export { embeddedFontFingerprint };

package/dist/fonts/embeddedFonts.d.ts

@@ -1,4 +1,3 @@
-//#region src/fonts/embeddedFonts.d.ts
 /**
  * Embedded-font extraction.
  *
@@ -77,5 +76,4 @@ export declare function buildEmbeddedFontFamilyMap(faces: readonly EmbeddedFont[
  * {@link getEmbeddedFontFaces}. Returns an empty list for documents with no
  * embedded fonts. See {@link getEmbeddedFontFaces} for `docNonce`.
  */
-export declare function extractEmbeddedFonts(buffer: ArrayBuffer, docNonce?: string): Promise<EmbeddedFont[]>;
-//#endregion
+export declare function extractEmbeddedFonts(buffer: ArrayBuffer, docNonce?: string): Promise<EmbeddedFont[]>;

package/dist/fonts/embeddedFonts.js

@@ -3,7 +3,7 @@ import { parseRelationships, resolveRelativePath } from "../docx/relsParser.js";
 import { unzipDocx } from "../docx/unzip.js";
 import { generateHexId } from "../utils/hexId.js";
 import { deobfuscateFont, isValidFontKey } from "./fontDeobfuscation.js";
-//#region src/fonts/embeddedFonts.ts
+// src/fonts/embeddedFonts.ts
 /**
 * Embedded-font extraction.
 *
@@ -137,5 +137,4 @@ async function extractEmbeddedFonts(buffer, docNonce = generateHexId()) {
 		fonts: raw.fonts
 	}, docNonce);
 }
-//#endregion
 export { buildEmbeddedFontFamilyMap, extractEmbeddedFonts, getEmbeddedFontFaces, scopeEmbeddedFontFamily };

package/dist/fonts/fontAlternates.d.ts

@@ -1,7 +1,5 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/fonts/fontAlternates.d.ts
 export type FontAlternates = ReadonlyMap<string, string>;
 /** Build a document-scoped primary-name → OOXML alternate-name lookup. */
 export declare const buildFontAlternates: (fontTable: document_d_exports.FontTable | null | undefined) => FontAlternates;
-export declare const getFontAlternate: (family: string | undefined, alternates: FontAlternates | undefined) => string | undefined;
-//#endregion
+export declare const getFontAlternate: (family: string | undefined, alternates: FontAlternates | undefined) => string | undefined;

package/dist/fonts/fontAlternates.js

@@ -1,4 +1,4 @@
-//#region src/fonts/fontAlternates.ts
+// src/fonts/fontAlternates.ts
 const MAX_ALTERNATE_NAME_LENGTH = 31;
 const normalizeFontName = (name) => name.trim().toLowerCase();
 /** Build a document-scoped primary-name → OOXML alternate-name lookup. */
@@ -13,5 +13,4 @@ const buildFontAlternates = (fontTable) => {
 	return alternates;
 };
 const getFontAlternate = (family, alternates) => family === void 0 ? void 0 : alternates?.get(normalizeFontName(family));
-//#endregion
 export { buildFontAlternates, getFontAlternate };

package/dist/fonts/fontDeobfuscation.d.ts

@@ -1,4 +1,3 @@
-//#region src/fonts/fontDeobfuscation.d.ts
 /**
  * Embedded-font de-obfuscation (ECMA-376 Part 4 §2.8.1, "Font Embedding").
  *
@@ -25,5 +24,4 @@ export declare function isValidFontKey(fontKey: string | undefined | null): bool
  * new array; the input is not mutated. Throws when `fontKey` is not a valid
  * 128-bit GUID (guard with {@link isValidFontKey} first).
  */
-export declare function deobfuscateFont(data: Uint8Array, fontKey: string): Uint8Array<ArrayBuffer>;
-//#endregion
+export declare function deobfuscateFont(data: Uint8Array, fontKey: string): Uint8Array<ArrayBuffer>;

package/dist/fonts/fontDeobfuscation.js

@@ -1,4 +1,4 @@
-//#region src/fonts/fontDeobfuscation.ts
+// src/fonts/fontDeobfuscation.ts
 /**
 * Embedded-font de-obfuscation (ECMA-376 Part 4 §2.8.1, "Font Embedding").
 *
@@ -57,5 +57,4 @@ function deobfuscateFont(data, fontKey) {
 	}
 	return out;
 }
-//#endregion
 export { deobfuscateFont, isValidFontKey };

package/dist/fonts/fontsourceFaces.d.ts

@@ -1,5 +1,4 @@
 import { HeadlessFontSource } from "./headlessMeasure.js";
-//#region src/fonts/fontsourceFaces.d.ts
 /** Where `@fontsource` files come from: `null` when the package or file is absent. */
 export type FontsourceFiles = {
   /** Bytes of `@fontsource/<packageName>/<relativePath>`. */
@@ -42,5 +41,4 @@ export type FontsourceFaces = {
   readonly fontFaceCss: (options?: FontsourceFontFaceCssOptions) => string;
 };
 /** The `@fontsource` faces, read through `files` and cached per face. */
-export declare const createFontsourceFaces: (files: FontsourceFiles) => FontsourceFaces;
-//#endregion
+export declare const createFontsourceFaces: (files: FontsourceFiles) => FontsourceFaces;