@stll/folio-core 0.63.1 → 0.64.1

package/dist/docx/server/docxToMarkdown.js

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

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

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

package/dist/docx/server/evaluateDocxXmlPatchProposal.js

@@ -4,7 +4,7 @@ import { DocxArchiveError } from "./boundedArchive.js";
 import { FolioDocxPackageInspectionError, inspectDocxPackage } from "./inspectDocxPackage.js";
 import { TaggedError, panic } from "better-result";
 import { createHash } from "node:crypto";
-//#region src/docx/server/evaluateDocxXmlPatchProposal.ts
+// src/docx/server/evaluateDocxXmlPatchProposal.ts
 const FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION = 1;
 const FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE = "folio-xml-patch-proposal-v1";
 const FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS = Object.freeze({
@@ -369,5 +369,4 @@ const evaluateDocxXmlPatchProposal = async ({ bytes, proposal: rawProposal, allo
 		limits
 	});
 };
-//#endregion
 export { FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal };

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

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

package/dist/docx/server/extractDocxText.js

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

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

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

package/dist/docx/server/inspectDocxPackage.js

@@ -3,7 +3,7 @@ import { getAttributeAnyPrefix, getLocalName, parseXmlDocument } from "../xmlPar
 import { DocxArchiveError, loadDocxArchive } from "./boundedArchive.js";
 import { Result, TaggedError } from "better-result";
 import { createHash } from "node:crypto";
-//#region src/docx/server/inspectDocxPackage.ts
+// src/docx/server/inspectDocxPackage.ts
 const FOLIO_DOCX_PACKAGE_INSPECTION_VERSION = 1;
 const FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS = Object.freeze({
 	maxXmlParts: 16,
@@ -219,5 +219,4 @@ const inspectDocxPackage = async (bytes, options = {}) => {
 		limits
 	};
 };
-//#endregion
 export { FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FolioDocxPackageInspectionError, inspectDocxPackage, readRequestedXmlParts };

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

@@ -1,5 +1,4 @@
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/server/materializeYjsDocx.d.ts
 declare const FolioYjsDocxMaterializationErrorBase: TaggedErrorClass<"FolioYjsDocxMaterializationError">;
 /** Yjs fragment that stores Folio's canonical ProseMirror document. */
 export declare const FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME = "prosemirror";
@@ -28,5 +27,4 @@ export type MaterializeYjsDocxOptions = {
  * of the browser editor's full save path for the main document story.
  */
 export declare const materializeYjsDocx: ({ sourceDocx, yjsUpdate }: MaterializeYjsDocxOptions) => Promise<ArrayBuffer>;
-//#endregion
 export {};

package/dist/docx/server/materializeYjsDocx.js

@@ -7,7 +7,7 @@ import { repackDocx } from "../rezip.js";
 import { Result, TaggedError } from "better-result";
 import { initProseMirrorDoc } from "y-prosemirror";
 import * as Y from "yjs";
-//#region src/docx/server/materializeYjsDocx.ts
+// src/docx/server/materializeYjsDocx.ts
 const FolioYjsDocxMaterializationErrorBase = TaggedError("FolioYjsDocxMaterializationError");
 /** Yjs fragment that stores Folio's canonical ProseMirror document. */
 const FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME = "prosemirror";
@@ -93,5 +93,4 @@ const materializeYjsDocx = async ({ sourceDocx, yjsUpdate }) => {
 	if (converted.isErr()) throw converted.error;
 	return await repackDocx(converted.value);
 };
-//#endregion
 export { FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_UPDATE_MAX_BYTES, FolioYjsDocxMaterializationError, materializeYjsDocx };

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

@@ -1,6 +1,5 @@
 import { FolioYjsAttrSchemaVersion } from "../../prosemirror/yjsDocumentMetadata.js";
 import { Result, TaggedErrorClass } from "better-result";
-//#region src/docx/server/migrateYjsAttrSchema.d.ts
 declare const FolioYjsSnapshotMigrationErrorBase: TaggedErrorClass<"FolioYjsSnapshotMigrationError">;
 /** Stable failure codes returned by an offline snapshot migration. */
 export declare const FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES: readonly ["invalid_update", "unsupported_version", "update_too_large"];
@@ -51,5 +50,4 @@ export type FolioYjsSnapshotMigrationResult = {
  * not clear it.
  */
 export declare const migrateFolioYjsSnapshot: (update: Uint8Array) => Result<FolioYjsSnapshotMigrationResult, FolioYjsSnapshotMigrationError>;
-//#endregion
 export {};

package/dist/docx/server/migrateYjsAttrSchema.js

@@ -2,7 +2,7 @@ import { FolioYjsNoteReferenceSchemaError, FolioYjsNumberingSourceSchemaError, a
 import { FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME } from "./materializeYjsDocx.js";
 import { Result, TaggedError } from "better-result";
 import * as Y from "yjs";
-//#region src/docx/server/migrateYjsAttrSchema.ts
+// src/docx/server/migrateYjsAttrSchema.ts
 const FolioYjsSnapshotMigrationErrorBase = TaggedError("FolioYjsSnapshotMigrationError");
 /** Stable failure codes returned by an offline snapshot migration. */
 const FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES = [
@@ -104,5 +104,4 @@ const migrateFolioYjsSnapshot = (update) => {
 		update: migrated
 	});
 };
-//#endregion
 export { FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES, FolioYjsSnapshotMigrationError, migrateFolioYjsSnapshot };

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

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../../types/document.js";
 import { DocxArchiveOptions } from "./boundedArchive.js";
-//#region src/docx/server/validateDocxConformance.d.ts
 export declare const FOLIO_DOCX_CONFORMANCE_REPORT_VERSION: 1;
 export declare const FOLIO_DOCX_CONFORMANCE_PROFILE: "folio-supported-v1";
 export declare const FOLIO_DOCX_CONFORMANCE_CHECKS: readonly ["archive-safety", "required-parts", "xml-well-formedness", "package-roots", "conformance-class", "canonical-model"];
@@ -35,5 +34,4 @@ export type ValidateDocxConformanceOptions = {
   readonly archive?: DocxArchiveOptions;
 };
 /** Assess a DOCX package against Folio's named, versioned support profile. */
-export declare const validateDocxConformance: (bytes: ArrayBuffer | Uint8Array, options?: ValidateDocxConformanceOptions) => Promise<FolioDocxConformanceReport>;
-//#endregion
+export declare const validateDocxConformance: (bytes: ArrayBuffer | Uint8Array, options?: ValidateDocxConformanceOptions) => Promise<FolioDocxConformanceReport>;

package/dist/docx/server/validateDocxConformance.js

@@ -8,7 +8,7 @@ import { XmlResourceLimitError } from "../xmlResourceLimits.js";
 import { getDocxXmlSafetyIssue } from "../xmlSafety.js";
 import { DocxArchiveError, loadDocxArchive } from "./boundedArchive.js";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
-//#region src/docx/server/validateDocxConformance.ts
+// src/docx/server/validateDocxConformance.ts
 const FOLIO_DOCX_CONFORMANCE_REPORT_VERSION = 1;
 const FOLIO_DOCX_CONFORMANCE_PROFILE = "folio-supported-v1";
 const FOLIO_DOCX_CONFORMANCE_CHECKS = Object.freeze([
@@ -359,5 +359,4 @@ const validateDocxConformance = async (bytes, options = {}) => {
 	await validateCanonicalModel(bytes, report);
 	return finishReport(report);
 };
-//#endregion
 export { FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, validateDocxConformance };

package/dist/docx/settingsHeaderFooterUpdate.d.ts

@@ -1,4 +1,2 @@
-//#region src/docx/settingsHeaderFooterUpdate.d.ts
 /** Null means the source is malformed or outside the supported namespace profiles. */
-export declare const updateEvenAndOddHeaders: (xml: string, enabled: boolean | undefined) => string | null;
-//#endregion
+export declare const updateEvenAndOddHeaders: (xml: string, enabled: boolean | undefined) => string | null;

package/dist/docx/settingsHeaderFooterUpdate.js

@@ -2,7 +2,7 @@ import { spliceXml } from "./selectiveXmlPatch.js";
 import { WORDPROCESSINGML_NAMESPACE_URIS, getChildElements, getLocalName, getNamespaceUri, parseXmlDocument } from "./xmlParser.js";
 import { panic } from "better-result";
 import { SETTINGS_CHILDREN } from "@stll/docx-core/schema";
-//#region src/docx/settingsHeaderFooterUpdate.ts
+// src/docx/settingsHeaderFooterUpdate.ts
 /** Preserve producer settings while updating the document-wide header/footer switch. */
 const XML_TOKEN = /<!--[\s\S]*?-->|<!\[CDATA\[[\s\S]*?\]\]>|<\?[\s\S]*?\?>|<(?:"[^"]*"|'[^']*'|[^'">])*>/gu;
 const SETTINGS_CHILD_ORDINALS = new Map(SETTINGS_CHILDREN.map((name, index) => [name, index]));
@@ -86,5 +86,4 @@ const updateEvenAndOddHeaders = (xml, enabled) => {
 	}
 	return spliceXml(xml, spans);
 };
-//#endregion
 export { updateEvenAndOddHeaders };

package/dist/docx/settingsParser.d.ts

@@ -1,6 +1,4 @@
 import { document_d_exports } from "../types/document.js";
 import { DEFAULT_TAB_STOP_TWIPS } from "@stll/docx-core/model";
-//#region src/docx/settingsParser.d.ts
 export declare function parseSettings(xml: string | null): document_d_exports.DocumentSettings;
-//#endregion
 export { DEFAULT_TAB_STOP_TWIPS };

package/dist/docx/settingsParser.js

@@ -1,7 +1,7 @@
 import { parseEndnoteProperties } from "./notePropertiesParser.js";
 import { WORDPROCESSINGML_NAMESPACE_URIS, findChild, findChildByNamespaceUri, findChildren, getAttribute, parseBooleanElement, parseXmlDocument } from "./xmlParser.js";
 import { DEFAULT_TAB_STOP_TWIPS, DEFAULT_TAB_STOP_TWIPS as DEFAULT_TAB_STOP_TWIPS$1 } from "@stll/docx-core/model";
-//#region src/docx/settingsParser.ts
+// src/docx/settingsParser.ts
 /**
 * settings.xml parser
 *
@@ -131,5 +131,4 @@ function parseDefaultTabStop(root) {
 	if (!Number.isFinite(parsed) || parsed < MIN_TAB_STOP_TWIPS || parsed > MAX_TAB_STOP_TWIPS) return DEFAULT_TAB_STOP_TWIPS$1;
 	return parsed;
 }
-//#endregion
 export { DEFAULT_TAB_STOP_TWIPS, parseSettings };

package/dist/docx/shadingParser.d.ts

@@ -1,6 +1,4 @@
 import { document_d_exports } from "../types/document.js";
 import { ParseContext } from "./parseContext.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/shadingParser.d.ts
-export declare function parseShading(shd: XmlElement | null, context?: ParseContext): document_d_exports.ShadingProperties | undefined;
-//#endregion
+export declare function parseShading(shd: XmlElement | null, context?: ParseContext): document_d_exports.ShadingProperties | undefined;

package/dist/docx/shadingParser.js

@@ -4,7 +4,7 @@ import { ShadingPatternSchema, narrowEnum } from "./parserEnums.js";
 import { SHADING_ATTRIBUTES } from "./propertyElementAttributes.js";
 import { parseThemeColorAttribute } from "./themeColorAttribute.js";
 import { getAttribute } from "./xmlParser.js";
-//#region src/docx/shadingParser.ts
+// src/docx/shadingParser.ts
 /** `ST_HexColor`'s reserved "let the consumer decide" token. */
 const AUTOMATIC_COLOR = "auto";
 const parseHexColor = (value) => {
@@ -64,5 +64,4 @@ function parseShading(shd, context) {
 	if (preservedAttributes) props.preservedAttributes = preservedAttributes;
 	return props;
 }
-//#endregion
 export { parseShading };

package/dist/docx/shapeAlternateContent.d.ts

@@ -1,6 +1,5 @@
 import { Shape, ShapeAlternateContent, ShapeContent } from "../types/content.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/shapeAlternateContent.d.ts
 /**
  * Capture the `mc:AlternateContent` a shape was read from, when the shape's
  * drawing is the sole child of the branch it came from.
@@ -22,5 +21,4 @@ export declare const refingerprintShapeAlternateContent: (shape: Shape, verbatim
  */
 export declare const replayableShapeAlternateContent: (content: ShapeContent) => string | undefined;
 /** Synchronize only a text-only edit, after the caller needs regenerated drawing markup. */
-export declare const synchronizedTextShapeAlternateContent: (content: ShapeContent, regeneratedDrawingXml: string) => string | undefined;
-//#endregion
+export declare const synchronizedTextShapeAlternateContent: (content: ShapeContent, regeneratedDrawingXml: string) => string | undefined;

package/dist/docx/shapeAlternateContent.js

@@ -3,7 +3,7 @@ import { captureVerbatimXml, isSafeCapturedXmlDocument } from "./verbatimCapture
 import { NAMESPACES, WORDPROCESSINGML_NAMESPACE_URIS, cloneWithXmlnsDeclarations, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, parseXmlDocument } from "./xmlParser.js";
 import { assertXmlResourceLimits } from "./xmlResourceLimits.js";
 import { panic } from "better-result";
-//#region src/docx/shapeAlternateContent.ts
+// src/docx/shapeAlternateContent.ts
 /**
 * Every modeled field, text body included: the Fallback repeats the shape's
 * geometry and its text, so an edit to either makes the captured element stale.
@@ -123,5 +123,4 @@ const synchronizedTextShapeAlternateContent = (content, regeneratedDrawingXml) =
 	if (captured === void 0 || captured.verbatimStructureFingerprint === void 0 || captured.verbatimStructureFingerprint !== shapeStructureFingerprint(content.shape)) return;
 	return updateAlternateContentText(captured.verbatimXml, regeneratedDrawingXml);
 };
-//#endregion
 export { captureShapeAlternateContent, refingerprintShapeAlternateContent, replayableShapeAlternateContent, synchronizedTextShapeAlternateContent };

package/dist/docx/shapeParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/shapeParser.d.ts
 /**
  * Parse a `<wps:wsp>` element into a Shape model. Does NOT pick up the
  * extent / position / wrap fields — those live on the wrapping
@@ -14,5 +13,4 @@ export declare function parseShape(node: XmlElement): document_d_exports.Shape;
  * `textBoxParser.parseTextBox`).
  */
 export declare function parseShapeFromDrawing(drawingEl: XmlElement): document_d_exports.Shape | null;
-export declare function shouldPreserveRawShapeDrawing(drawingEl: XmlElement): boolean;
-//#endregion
+export declare function shouldPreserveRawShapeDrawing(drawingEl: XmlElement): boolean;

package/dist/docx/shapeParser.js

@@ -3,7 +3,7 @@ import { parseAnchorPosition, parseAnchorWrap, parseFill, parseInlineWrap, parse
 import { parseNonVisualDrawingNames } from "./nonVisualDrawingProps.js";
 import { ShapeTypeSchema, narrowEnum } from "./parserEnums.js";
 import { findAllDeep, findChildByLocalName, findChildren, getAttribute, getChildElements, parseNumericAttribute, parseOnOffAttribute } from "./xmlParser.js";
-//#region src/docx/shapeParser.ts
+// src/docx/shapeParser.ts
 /** Convert OOXML rotation (1/60000ths of a degree) to degrees. */
 function rotToDegrees(rot) {
 	if (rot === null || rot === void 0) return;
@@ -218,5 +218,4 @@ function shouldPreserveRawShapeDrawing(drawingEl) {
 	if (!wsp || findChildByLocalName(wsp, "txbx") !== null) return false;
 	return shapeNeedsRawPreservation(findChildByLocalName(wsp, "spPr"));
 }
-//#endregion
 export { parseShape, parseShapeFromDrawing, shouldPreserveRawShapeDrawing };

package/dist/docx/storyBlockReplay.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/storyBlockReplay.d.ts
 type MaterializeReplayFragmentOptions = {
   xml: string;
   element: XmlElement;
@@ -27,5 +26,4 @@ type DocumentBlockReplayOptions = {
 };
 /** Replay body blocks and modeled document metadata inside the authored part shell. */
 export declare const buildDocumentBlockReplay: ({ sourceXml, serializedXml, baseline, current }: DocumentBlockReplayOptions) => string | null;
-//#endregion
 export {};

package/dist/docx/storyBlockReplay.js

@@ -6,7 +6,7 @@ import { captureSourceProfileXml, isSafeCapturedXmlDocument } from "./verbatimCa
 import { WORDPROCESSINGML_NAMESPACE_URIS, getAttributeByNamespaceUri, getChildElements, getLocalName, getNamespaceUri } from "./xmlParser.js";
 import { escapeXmlAttribute } from "@stll/docx-core";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
-//#region src/docx/storyBlockReplay.ts
+// src/docx/storyBlockReplay.ts
 const BLOCK_ELEMENT_NAMES = {
 	paragraph: "p",
 	table: "tbl",
@@ -475,5 +475,4 @@ const buildDocumentBlockReplay = ({ sourceXml, serializedXml, baseline, current
 	}
 	return result;
 };
-//#endregion
 export { buildDocumentBlockReplay, buildStoryBlockReplay, canReplayDocumentSource, materializeReplayFragment };

package/dist/docx/storyPlainText.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/storyPlainText.d.ts
 /** Read the document body with pending revisions accepted. */
 export declare const getDocumentText: (body: document_d_exports.DocumentBody) => string;
 /** Approximate word count of the accepted body text. */
@@ -15,5 +14,4 @@ export declare const getHeaderFooterText: (headerFooter: document_d_exports.Head
 /** Read accepted footnote content, including nested blocks. */
 export declare const getFootnoteText: (footnote: document_d_exports.Footnote) => string;
 /** Read accepted endnote content, including nested blocks. */
-export declare const getEndnoteText: (endnote: document_d_exports.Endnote) => string;
-//#endregion
+export declare const getEndnoteText: (endnote: document_d_exports.Endnote) => string;

package/dist/docx/storyPlainText.js

@@ -1,5 +1,5 @@
 import { blockPlainText } from "./blockPlainText.js";
-//#region src/docx/storyPlainText.ts
+// src/docx/storyPlainText.ts
 /** Read the document body with pending revisions accepted. */
 const getDocumentText = (body) => blockPlainText(body.content);
 /** Approximate word count of the accepted body text. */
@@ -19,5 +19,4 @@ const getHeaderFooterText = (headerFooter) => blockPlainText(headerFooter.conten
 const getFootnoteText = (footnote) => blockPlainText(footnote.content);
 /** Read accepted endnote content, including nested blocks. */
 const getEndnoteText = (endnote) => blockPlainText(endnote.content);
-//#endregion
 export { getCharacterCount, getDocumentText, getEndnoteText, getFootnoteText, getHeaderFooterText, getTableText, getTextBoxText, getWordCount };

package/dist/docx/streamingXmlParser.d.ts

@@ -1,5 +1,4 @@
 import { XmlElement, XmlNamespaceScope } from "./xmlParser.js";
-//#region src/docx/streamingXmlParser.d.ts
 type ParseXmlResult = {
   status: "parsed";
   value: XmlElement;
@@ -58,5 +57,4 @@ export declare const scanStreamingXmlElements: (xml: string, visitElement: Eleme
 } | {
   status: "scanned";
 };
-//#endregion
 export {};

package/dist/docx/streamingXmlParser.js

@@ -1,7 +1,7 @@
 import { EMPTY_NAMESPACE_SCOPE, attachXmlNamespaceContext } from "./xmlNamespaceContext.js";
 import { FOLIO_XML_RESOURCE_LIMITS } from "./xmlResourceLimits.js";
 import { isOoxmlNumericIdAttributeName } from "@stll/docx-core";
-//#region src/docx/streamingXmlParser.ts
+// src/docx/streamingXmlParser.ts
 const sourceRanges = /* @__PURE__ */ new WeakMap();
 /** Exact element source ranges, available only from the opt-in source-range reader. */
 const getXmlSourceRange = (element) => sourceRanges.get(element);
@@ -403,5 +403,4 @@ const isUnsafePropertyName = (name) => {
 		default: return false;
 	}
 };
-//#endregion
 export { getXmlSourceRange, parseStreamingXml, parseStreamingXmlWithIdentityVisitor, parseStreamingXmlWithSourceRanges, rewriteStreamingXmlDecimalAttributes, scanStreamingXmlElements, scanStreamingXmlNumericIdAttributes };

package/dist/docx/strictNames.d.ts

@@ -1,10 +1,8 @@
 import { XmlElement } from "./xmlParser.js";
 import { RenamedSlot } from "./strictNames.gen.js";
-//#region src/docx/strictNames.d.ts
 /** A renamed child of `parent`, in whichever spelling the document used. */
 export declare const findChildAnySpelling: (parent: XmlElement | null | undefined, slot: RenamedSlot) => XmlElement | null;
 /** A renamed attribute's number, in whichever spelling the document used. */
 export declare const numericAttributeAnySpelling: (element: XmlElement | null | undefined, slot: RenamedSlot) => number | undefined;
 /** Whether the element carries a renamed attribute under either spelling. */
-export declare const hasAttributeAnySpelling: (element: XmlElement | null | undefined, slot: RenamedSlot) => boolean;
-//#endregion
+export declare const hasAttributeAnySpelling: (element: XmlElement | null | undefined, slot: RenamedSlot) => boolean;

package/dist/docx/strictNames.gen.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/strictNames.gen.d.ts
 /**
  * GENERATED FILE — do not edit.
  *
@@ -40,5 +39,4 @@ export declare const STRICT_NAMES_BY_TRANSITIONAL_NAME: {
   readonly "CT_TblWidth right": readonly ["end"];
 };
 /** A slot a reader must take in either spelling, keyed the same way. */
-export type RenamedSlot = keyof typeof STRICT_NAMES_BY_TRANSITIONAL_NAME;
-//#endregion
+export type RenamedSlot = keyof typeof STRICT_NAMES_BY_TRANSITIONAL_NAME;

package/dist/docx/strictNames.gen.js

@@ -1,4 +1,4 @@
-//#region src/docx/strictNames.gen.ts
+// src/docx/strictNames.gen.ts
 /**
 * GENERATED FILE — do not edit.
 *
@@ -46,5 +46,4 @@ const STRICT_NAMES_BY_TRANSITIONAL_NAME = {
 	"CT_TblWidth left": ["start"],
 	"CT_TblWidth right": ["end"]
 };
-//#endregion
 export { STRICT_NAMES, STRICT_NAMES_BY_TRANSITIONAL_NAME, TRANSITIONAL_NAME_BY_STRICT_NAME };

package/dist/docx/strictNames.js

@@ -1,6 +1,6 @@
 import { STRICT_NAMES_BY_TRANSITIONAL_NAME } from "./strictNames.gen.js";
 import { findChild, getAttribute, parseNumericAttribute } from "./xmlParser.js";
-//#region src/docx/strictNames.ts
+// src/docx/strictNames.ts
 /**
 * Reading a slot whose name a Strict producer spells by writing direction.
 *
@@ -39,5 +39,4 @@ const numericAttributeAnySpelling = (element, slot) => {
 };
 /** Whether the element carries a renamed attribute under either spelling. */
 const hasAttributeAnySpelling = (element, slot) => spellingsOf(slot).some((spelling) => getAttribute(element, "w", spelling) !== null);
-//#endregion
 export { findChildAnySpelling, hasAttributeAnySpelling, numericAttributeAnySpelling };

package/dist/docx/strictValueEncodings.gen.d.ts

@@ -1,5 +1,4 @@
 import { MeasureUnit } from "./universalMeasure.js";
-//#region src/docx/strictValueEncodings.gen.d.ts
 /** The fraction of a percent a Transitional attribute's number counts. */
 export type PercentUnit = "fiftiethPercent" | "thousandthPercent" | "wholePercent";
 /** The number a slot's dual-spelling type accepts in place of a Strict string. */
@@ -10,5 +9,4 @@ export type SlotEncoding = {
 /** Slots whose Transitional type spells one value two ways. */
 export declare const TRANSITIONAL_SLOT_ENCODINGS: ReadonlyMap<string, SlotEncoding>;
 /** Every Strict namespace URI a WordprocessingML part can carry, and its Transitional pair. */
-export declare const TRANSITIONAL_NAMESPACE_BY_STRICT_URI: ReadonlyMap<string, string>;
-//#endregion
+export declare const TRANSITIONAL_NAMESPACE_BY_STRICT_URI: ReadonlyMap<string, string>;

package/dist/docx/strictValueEncodings.gen.js

@@ -1,4 +1,4 @@
-//#region src/docx/strictValueEncodings.gen.ts
+// src/docx/strictValueEncodings.gen.ts
 const MEASURE_UNITS = {
 	emu: "emu",
 	halfPoints: "halfPoints",
@@ -273,5 +273,4 @@ const TRANSITIONAL_NAMESPACE_BY_STRICT_URI = /* @__PURE__ */ new Map([
 	["http://purl.oclc.org/ooxml/schemaLibrary/main", "http://schemas.openxmlformats.org/schemaLibrary/2006/main"],
 	["http://purl.oclc.org/ooxml/wordprocessingml/main", "http://schemas.openxmlformats.org/wordprocessingml/2006/main"]
 ]);
-//#endregion
 export { TRANSITIONAL_NAMESPACE_BY_STRICT_URI, TRANSITIONAL_SLOT_ENCODINGS };

package/dist/docx/structuralXmlPatch.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/structuralXmlPatch.d.ts
 type StructuralPatchOptions = {
   originalXml: string;
   serializedXml: string;
@@ -10,5 +9,4 @@ type StructuralPatchOptions = {
  * Id-less sources need an explicit ensureParaIds ingest before structural editing.
  */
 export declare const buildStructuralDocumentPatch: ({ originalXml, serializedXml, changedIds }: StructuralPatchOptions) => string | null;
-//#endregion
 export {};

package/dist/docx/structuralXmlPatch.js

@@ -4,7 +4,7 @@ import { paraIdAttribute } from "./paraIdAttribute.js";
 import { spliceSupportsRootNamespaces, spliceXml } from "./selectiveXmlPatch.js";
 import { materializeReplayFragment } from "./storyBlockReplay.js";
 import { NAMESPACES, WORDPROCESSINGML_NAMESPACE_URIS, getChildElements, getLocalName, getNamespaceUri, parseXmlDocument } from "./xmlParser.js";
-//#region src/docx/structuralXmlPatch.ts
+// src/docx/structuralXmlPatch.ts
 /** Conservative body-paragraph splices; source offsets never come from reserialization. */
 const isWordElement = (element, name) => getLocalName(element.name) === name && WORDPROCESSINGML_NAMESPACE_URIS.has(getNamespaceUri(element) ?? "");
 /** Match XML tokens, skipping quoted delimiters, comments, CDATA and processing instructions. */
@@ -200,5 +200,4 @@ const buildStructuralDocumentPatch = ({ originalXml, serializedXml, changedIds }
 	})) return null;
 	return spliceXml(originalXml, splices);
 };
-//#endregion
 export { buildStructuralDocumentPatch };

package/dist/docx/styleParser.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/styleParser.d.ts
 /**
  * Style map keyed by styleId
  */
@@ -48,5 +47,4 @@ export declare function getDefaultCharacterStyle(styleMap: StyleMap): document_d
 /**
  * Get all styles of a specific type
  */
-export declare function getStylesByType(styleMap: StyleMap, type: document_d_exports.StyleType): document_d_exports.Style[];
-//#endregion
+export declare function getStylesByType(styleMap: StyleMap, type: document_d_exports.StyleType): document_d_exports.Style[];

package/dist/docx/styleParser.js

@@ -9,7 +9,7 @@ import { parseShading } from "./shadingParser.js";
 import { findChildAnySpelling } from "./strictNames.js";
 import { parseTableLook } from "./tableParser.js";
 import { findChild, findChildren, getAttribute, getLocalName, parseBooleanElement, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXmlDocument } from "./xmlParser.js";
-//#region src/docx/styleParser.ts
+// src/docx/styleParser.ts
 /**
 * Parse table measurement (width/height with type)
 */
@@ -551,5 +551,4 @@ function getStylesByType(styleMap, type) {
 	for (const style of styleMap.values()) if (style.type === type) result.push(style);
 	return result;
 }
-//#endregion
 export { getDefaultCharacterStyle, getDefaultParagraphStyle, getResolvedStyle, getStylesByType, parseStyleDefinitions, parseStyles, parseStylesPackage, resolveStyleInheritance };

package/dist/docx/styleReferenceResolution.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/styleReferenceResolution.d.ts
 /**
  * Every style a package points at must be a style that package defines.
  *
@@ -31,5 +30,4 @@ export type DanglingStyleReference = {
  * `word/endnotes.xml`, `word/comments.xml`, and `word/styles.xml` itself for
  * the `basedOn`/`next`/`link` graph).
  */
-export declare const danglingStyleReferences: (stylesXml: string | undefined, parts: ReadonlyMap<string, string>) => DanglingStyleReference[];
-//#endregion
+export declare const danglingStyleReferences: (stylesXml: string | undefined, parts: ReadonlyMap<string, string>) => DanglingStyleReference[];

package/dist/docx/styleReferenceResolution.js

@@ -1,4 +1,4 @@
-//#region src/docx/styleReferenceResolution.ts
+// src/docx/styleReferenceResolution.ts
 /**
 * Every style a package points at must be a style that package defines.
 *
@@ -47,5 +47,4 @@ const danglingStyleReferences = (stylesXml, parts) => {
 	}
 	return dangling;
 };
-//#endregion
 export { danglingStyleReferences };

package/dist/docx/tableLook.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/tableLook.d.ts
 /**
  * Every flag, in the order `CT_TblLook` declares them.
  *
@@ -53,5 +52,4 @@ type SetTableLookFlagsOptions = {
  * format reserves the rest — and folio has nothing to put there.
  */
 export declare const setTableLookFlags: ({ look, flags }: SetTableLookFlagsOptions) => document_d_exports.TableLook;
-//#endregion
 export {};

package/dist/docx/tableLook.js

@@ -1,4 +1,4 @@
-//#region src/docx/tableLook.ts
+// src/docx/tableLook.ts
 /**
 * Every flag, in the order `CT_TblLook` declares them.
 *
@@ -59,5 +59,4 @@ const setTableLookFlags = ({ look, flags }) => ({
 	...look,
 	...flags
 });
-//#endregion
 export { TABLE_LOOK_BITS, TABLE_LOOK_FLAGS, resolveTableLook, setTableLookFlags };

package/dist/docx/tableParser.d.ts

@@ -5,7 +5,6 @@ import { XmlElement } from "./xmlParser.js";
 import { OwnedElsewhere } from "./containerChildren.js";
 import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
-//#region src/docx/tableParser.d.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
@@ -371,5 +370,4 @@ export declare function getHeaderRows(table: document_d_exports.Table): document
  * @returns true if table has floating properties
  */
 export declare function isFloatingTable(table: document_d_exports.Table): boolean;
-//#endregion
 export {};