@stll/folio-core 0.63.1 → 0.64.1

package/dist/docx/packageParts.js

@@ -1,7 +1,7 @@
 import { decodeText, encodeUtf8 } from "../utils/textEncoding.js";
 import { Result } from "better-result";
 import { writeZipPart } from "@stll/docx-core/zip";
-//#region src/docx/packageParts.ts
+// src/docx/packageParts.ts
 /**
 * What a repack carries out of the source package, and the guarantee that
 * nothing in the output points at a part the output does not hold.
@@ -266,5 +266,4 @@ const checkPackageIntegrity = async (zip) => {
 	}
 	return report;
 };
-//#endregion
 export { checkPackageIntegrity, isUnsafePackagePath, reconcilePackageReferences, removeUnsafeEntries, resolvePackageRelationshipTarget };

package/dist/docx/paraIdAttribute.d.ts

@@ -1,5 +1,4 @@
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/paraIdAttribute.d.ts
 /**
  * The namespaces a paraId-valued attribute may be written in: the Word 2010,
  * 2012 and 2018 wordml extensions.
@@ -107,5 +106,4 @@ export type ResolveParagraphIdentitiesOptions = {
  * duplicate is refused rather than silently addressed by position. An id the
  * source does not write at all is `minted`.
  */
-export declare const resolveParagraphIdentities: ({ sourceParaIds, serializedParaIds }: ResolveParagraphIdentitiesOptions) => ParagraphIdentityPlan;
-//#endregion
+export declare const resolveParagraphIdentities: ({ sourceParaIds, serializedParaIds }: ResolveParagraphIdentitiesOptions) => ParagraphIdentityPlan;

package/dist/docx/paraIdAttribute.js

@@ -1,6 +1,6 @@
 import { OOXML_NAMESPACES } from "./serializer/partNamespaces.js";
 import { NAMESPACES, WORDPROCESSINGML_NAMESPACE_URIS, getAttributeByNamespaceUri } from "./xmlParser.js";
-//#region src/docx/paraIdAttribute.ts
+// src/docx/paraIdAttribute.ts
 /**
 * The one reader for "the paraId written on this element".
 *
@@ -138,5 +138,4 @@ const resolveParagraphIdentities = ({ sourceParaIds, serializedParaIds }) => {
 		ordinalsAligned: alignParagraphOrdinals(sourceIdentities, identities).consistent
 	};
 };
-//#endregion
 export { PARA_ID_NAMESPACE_URIS, alignParagraphOrdinals, paraIdAttribute, paraIdParentAttribute, resolveParagraphIdentities, textIdAttribute };

package/dist/docx/paraIdRangeNormalization.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/paraIdRangeNormalization.d.ts
 /**
  * `value` when it already fits, and a value derived from it when it does not.
  *
@@ -16,5 +15,4 @@ export declare const paraIdInRange: (value: string) => string;
  * Returns the parts unchanged when every id already fits, so a save of a
  * document that never carried one is byte-identical.
  */
-export declare const normalizeParaIdRangeInXmlParts: (parts: ReadonlyMap<string, string>) => Map<string, string>;
-//#endregion
+export declare const normalizeParaIdRangeInXmlParts: (parts: ReadonlyMap<string, string>) => Map<string, string>;

package/dist/docx/paraIdRangeNormalization.js

@@ -1,5 +1,5 @@
 import { deterministicHexId } from "../utils/hexId.js";
-//#region src/docx/paraIdRangeNormalization.ts
+// src/docx/paraIdRangeNormalization.ts
 /**
 * Keep every paragraph id a package carries inside the range the schema gives
 * it.
@@ -60,5 +60,4 @@ const normalizeParaIdRangeInXmlParts = (parts) => {
 	}
 	return normalized;
 };
-//#endregion
 export { normalizeParaIdRangeInXmlParts, paraIdInRange };

package/dist/docx/paragraphMarkPropertyPresence.d.ts

@@ -1,8 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/paragraphMarkPropertyPresence.d.ts
 export declare const EMPTY_MARK_PROPERTIES_ATTRIBUTE = "emptyMarkProperties";
 /** A paragraph-owned rPr carrier cannot distinguish absent and explicitly empty formatting. */
 export declare const serializeEmptyMarkProperties: (paragraph: document_d_exports.Paragraph) => string | undefined;
-export declare const restoreEmptyMarkProperties: (paragraph: document_d_exports.Paragraph, element: XmlElement) => void;
-//#endregion
+export declare const restoreEmptyMarkProperties: (paragraph: document_d_exports.Paragraph, element: XmlElement) => void;

package/dist/docx/paragraphMarkPropertyPresence.js

@@ -1,7 +1,7 @@
 import { OOXML_NAMESPACES } from "./serializer/partNamespaces.js";
 import { getAttributeByNamespaceUri } from "./xmlParser.js";
 import { EMPTY_PROPERTY_SETS } from "@stll/docx-core/ops";
-//#region src/docx/paragraphMarkPropertyPresence.ts
+// src/docx/paragraphMarkPropertyPresence.ts
 const EMPTY_MARK_PROPERTIES_ATTRIBUTE = "emptyMarkProperties";
 const REVIEW_HISTORY_NAMESPACES = /* @__PURE__ */ new Set([OOXML_NAMESPACES.folio.uri]);
 /** A paragraph-owned rPr carrier cannot distinguish absent and explicitly empty formatting. */
@@ -17,5 +17,4 @@ const restoreEmptyMarkProperties = (paragraph, element) => {
 		runProperties: {}
 	};
 };
-//#endregion
 export { EMPTY_MARK_PROPERTIES_ATTRIBUTE, restoreEmptyMarkProperties, serializeEmptyMarkProperties };

package/dist/docx/paragraphParser.d.ts

@@ -3,7 +3,6 @@ import { NumberingMap } from "./numberingParser.js";
 import { XmlElement } from "./xmlParser.js";
 import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
-//#region src/docx/paragraphParser.d.ts
 export declare function parseParagraphPropertyChanges(pPr: XmlElement | null, theme: document_d_exports.Theme | null, currentFormatting: document_d_exports.ParagraphFormatting | undefined): document_d_exports.ParagraphPropertyChange[] | undefined;
 type ParseParagraphOptions = {
   inHeaderFooter?: boolean;
@@ -70,5 +69,4 @@ export declare function hasStyle(paragraph: document_d_exports.Paragraph, styleI
  * @returns The variable name or null
  */
 export declare function getTemplateVariable(paragraph: document_d_exports.Paragraph): string | null;
-//#endregion
 export {};

package/dist/docx/paragraphParser.js

@@ -35,7 +35,7 @@ import { isVmlPictParsedByRunParser } from "./vmlImageParser.js";
 import { WORDPROCESSINGML_NAMESPACE_URIS, cloneElement, findChild, findChildByNamespaceUri, findChildrenByNamespaceUri, findWordprocessingChild, getAttribute, getAttributeByNamespaceUri, getChildElements, getLocalName, getNamespaceUri, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, selectAlternateContentBranch } from "./xmlParser.js";
 import { panic } from "better-result";
 import { PARAGRAPH_MARK_CHANGE_KINDS, REVIEW_CARRIERS } from "@stll/docx-core/model";
-//#region src/docx/paragraphParser.ts
+// src/docx/paragraphParser.ts
 /**
 * Paragraph Parser - Parse paragraphs (w:p) with complete formatting
 *
@@ -1503,5 +1503,4 @@ function getTemplateVariable(paragraph) {
 	if (end === -1 || end === start + 2) return null;
 	return text.slice(start + 2, end);
 }
-//#endregion
 export { getListLevel, getParagraphText, getTemplateVariable, hasStyle, isEmptyParagraph, isListItem, parseParagraph, parseParagraphPropertyChanges };

package/dist/docx/paragraphProperties.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/paragraphProperties.d.ts
 /**
  * Read `w:pPr` into {@link ParagraphFormatting}, every declared child carrying
  * a decision.
@@ -18,5 +17,4 @@ import { XmlElement } from "./xmlParser.js";
  * set, read below off the element for the same reason a run's is read off the
  * run.
  */
-export declare function parseParagraphProperties(pPr: XmlElement | null, theme: document_d_exports.Theme | null): document_d_exports.ParagraphFormatting | undefined;
-//#endregion
+export declare function parseParagraphProperties(pPr: XmlElement | null, theme: document_d_exports.Theme | null): document_d_exports.ParagraphFormatting | undefined;

package/dist/docx/paragraphProperties.js

@@ -10,7 +10,7 @@ import { numericAttributeAnySpelling } from "./strictNames.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
 import { findChild, findChildren, getAttribute, parseBooleanElement, parseNumericAttribute, parseOnOffAttribute, parseOnOffChild } from "./xmlParser.js";
 import { outlineLevelFromStatedValue } from "@stll/docx-core/model";
-//#region src/docx/paragraphProperties.ts
+// src/docx/paragraphProperties.ts
 /**
 * The one reader for a paragraph property set (`w:pPr`).
 *
@@ -304,5 +304,4 @@ const readParagraphIndentation = (ind, formatting) => {
 	if (preservedAttributes) formatting.indentPreservedAttributes = preservedAttributes;
 	return true;
 };
-//#endregion
 export { parseParagraphProperties };

package/dist/docx/paragraphPropertySource.d.ts

@@ -3,7 +3,6 @@ import { ModeledParagraphFormattingEmission } from "../internal/paragraphFormatt
 import { Fragment, Mark, Node, NodeType } from "prosemirror-model";
 import { Transaction } from "prosemirror-state";
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/paragraphPropertySource.d.ts
 declare const paragraphPropertySourceEmissionFingerprint: unique symbol;
 declare const paragraphPropertySourceIndentationBaseline: unique symbol;
 declare const INDENTATION_FIELDS: readonly ["indentLeft", "indentRight", "indentFirstLine", "hangingIndent"];
@@ -179,5 +178,4 @@ export declare const transferProseParagraphPropertySource: (target: Node, source
 export declare const linkParagraphPropertySourceCandidate: (target: document_d_exports.Paragraph, source: Node) => void;
 export declare const getParagraphPropertySourceCandidate: (paragraph: document_d_exports.Paragraph) => document_d_exports.Paragraph | undefined;
 export declare const getParagraphPropertySourceTransferId: (paragraph: document_d_exports.Paragraph) => string | undefined;
-//#endregion
 export {};

package/dist/docx/paragraphPropertySource.js

@@ -5,7 +5,7 @@ import { parseParagraphProperties } from "./paragraphProperties.js";
 import { visitDocxParagraphs } from "./paragraphTraversal.js";
 import { parseXmlDocument } from "./xmlParser.js";
 import { TaggedError, panic } from "better-result";
-//#region src/docx/paragraphPropertySource.ts
+// src/docx/paragraphPropertySource.ts
 const paragraphPropertySourceEmissionFingerprint = Symbol("paragraphPropertySourceEmissionFingerprint");
 const paragraphPropertySourceIndentationBaseline = Symbol("paragraphPropertySourceIndentationBaseline");
 const INDENTATION_FIELDS = [
@@ -931,5 +931,4 @@ const linkParagraphPropertySourceCandidate = (target, source) => {
 };
 const getParagraphPropertySourceCandidate = (paragraph) => paragraphPropertySourceCandidates.get(paragraph);
 const getParagraphPropertySourceTransferId = (paragraph) => paragraphPropertySourceTransferIds.get(paragraph);
-//#endregion
 export { PARAGRAPH_PROPERTY_SOURCE_VALIDATION_CODES, PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR, ParagraphPropertySourceValidationError, TABLE_CELL_PARAGRAPH_SOURCE_BINDING_ATTR, TABLE_CELL_PARAGRAPH_SOURCE_PAYLOAD_ERROR_CLASSIFICATIONS, assignDocumentParagraphPropertySourceContract, assignParagraphIndentationProjection, assignParagraphPropertySource, cloneDocumentWithParagraphPropertySources, cloneParagraphWithPropertySource, cloneParagraphWithoutPropertySource, cloneTableCellsWithParagraphPropertyCaptures, copyDocumentParagraphPropertySourceContract, copyDocumentParagraphPropertySources, copyParagraphIndentationProjection, copyParagraphPropertyCapture, copyParagraphPropertySource, createProseParagraphWithPropertySource, decodeTableCellParagraphSourcePayload, getDocumentParagraphPropertySourceContract, getExplicitParagraphPropertySourceTransfers, getParagraphPropertySource, getParagraphPropertySourceCandidate, getParagraphPropertySourceToken, getParagraphPropertySourceTransferId, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, inspectParagraphSourceIdentity, isParagraphPropertySourceToken, joinProseParagraphsWithRightPropertySource, linkParagraphPropertySourceCandidate, linkProseParagraphPropertySource, markParagraphPropertySourceTransfers, paragraphFormattingWithAuthoredIndentation, paragraphPropertySourceBelongsToDocument, paragraphPropertySourceMatchesAuthoredIndentation, paragraphPropertySourceMatchesEmission, paragraphPropertySourceTokenMatchesContract, proseParagraphAttrsWithoutPropertySource, recreateProseNodeWithDetachedParagraphPropertySource, recreateProseNodeWithParagraphPropertySource, restoreParagraphIndentationProjection, restoreTableCellsWithParagraphPropertySources, sameParagraphIndentationProjection, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource, transportTableCellsWithParagraphPropertySources, visitDocumentStoryParagraphs, visitTableCellParagraphPropertySourceBindings };

package/dist/docx/paragraphTextBoxEnrichment.d.ts

@@ -5,6 +5,4 @@ import { XmlElement } from "./xmlParser.js";
 import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
 import { TableParserFn } from "./textBoxParser.js";
-//#region src/docx/paragraphTextBoxEnrichment.d.ts
-export declare const enrichParagraphTextBoxes: (paragraph: document_d_exports.Paragraph, paraXml: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null, parseTable: TableParserFn, previews: PreviewLedger, context?: ParseContext) => void;
-//#endregion
+export declare const enrichParagraphTextBoxes: (paragraph: document_d_exports.Paragraph, paraXml: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null, parseTable: TableParserFn, previews: PreviewLedger, context?: ParseContext) => void;

package/dist/docx/paragraphTextBoxEnrichment.js

@@ -7,7 +7,7 @@ import { captureShapeAlternateContent } from "./shapeAlternateContent.js";
 import { getTextBoxContentElement, parseTextBox, parseTextBoxContent, parseTextBoxFromShape, scanRunForTextBoxDrawings } from "./textBoxParser.js";
 import { isVmlPictParsedByRunParser } from "./vmlImageParser.js";
 import { WORDPROCESSINGML_NAMESPACE_URIS, findChildByLocalName, findChildByNamespaceUri, findDeep, findWordprocessingChild, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
-//#region src/docx/paragraphTextBoxEnrichment.ts
+// src/docx/paragraphTextBoxEnrichment.ts
 const VML_HORIZONTAL_RELATIVES = /* @__PURE__ */ new Set([
 	"character",
 	"column",
@@ -460,5 +460,4 @@ const parseVmlTextBoxShape = (pictEl, { styles, theme, numbering, rels, media, p
 	};
 	return shape;
 };
-//#endregion
 export { enrichParagraphTextBoxes };

package/dist/docx/paragraphTraversal.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/paragraphTraversal.d.ts
 export type DocxParagraphSurfaces = {
   documentBody: document_d_exports.DocumentBody;
   headers?: Map<string, document_d_exports.HeaderFooter> | undefined;
@@ -59,5 +58,4 @@ export type DocxContentSlot = {
 } | ({
   type: "inline";
 } & InlineContentSlot);
-export declare const visitDocxContentSlots: (surfaces: DocxParagraphSurfaces, visit: (slot: DocxContentSlot) => void) => void;
-//#endregion
+export declare const visitDocxContentSlots: (surfaces: DocxParagraphSurfaces, visit: (slot: DocxContentSlot) => void) => void;

package/dist/docx/paragraphTraversal.js

@@ -1,5 +1,5 @@
 import { panic } from "better-result";
-//#region src/docx/paragraphTraversal.ts
+// src/docx/paragraphTraversal.ts
 const visitDirectParagraphRuns = (content, visit) => {
 	switch (content.type) {
 		case "run":
@@ -195,5 +195,4 @@ const visitDocxContentSlots = (surfaces, visit) => {
 		for (const block of surfaceBlocks) previousSurfaceBlocks.add(block);
 	});
 };
-//#endregion
 export { BLOCK_TREE_DESCENT, visitBlockTreeRecords, visitDocxContentSlots, visitDocxParagraphs, visitInlineContentSlots, visitInlineContentSlotsInContent, visitParagraphRuns };

package/dist/docx/parseContext.d.ts

@@ -1,5 +1,4 @@
 import { ImportedIdCollisionKind, ParseWarning, ParseWarningCode } from "@stll/docx-core/model";
-//#region src/docx/parseContext.d.ts
 /** What a call site states; the collector supplies the rest. */
 export type ParseWarningReport = {
   code: ParseWarningCode;
@@ -33,5 +32,4 @@ export type ParseWarningCollector = {
    */
   warnings: () => ParseWarning[];
 };
-export declare const createParseWarningCollector: (part?: string) => ParseWarningCollector;
-//#endregion
+export declare const createParseWarningCollector: (part?: string) => ParseWarningCollector;

package/dist/docx/parseContext.js

@@ -1,5 +1,5 @@
 import { MAX_RETAINED_PARSE_WARNINGS_PER_CODE } from "@stll/docx-core/model";
-//#region src/docx/parseContext.ts
+// src/docx/parseContext.ts
 /**
 * The channel a parser reports a normalisation through.
 *
@@ -64,5 +64,4 @@ const createParseWarningCollector = (part = PACKAGE_PART) => {
 		}))]
 	};
 };
-//#endregion
 export { createParseWarningCollector };

package/dist/docx/parseWarningMessage.d.ts

@@ -1,5 +1,3 @@
 import { ParseWarning } from "@stll/docx-core/model";
-//#region src/docx/parseWarningMessage.d.ts
 export declare const formatParseWarning: (warning: ParseWarning) => string;
-export declare const formatParseWarnings: (warnings: readonly ParseWarning[]) => string[];
-//#endregion
+export declare const formatParseWarnings: (warnings: readonly ParseWarning[]) => string[];

package/dist/docx/parseWarningMessage.js

@@ -1,5 +1,5 @@
 import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
-//#region src/docx/parseWarningMessage.ts
+// src/docx/parseWarningMessage.ts
 /**
 * The one place a parse warning becomes a sentence.
 *
@@ -48,5 +48,4 @@ const PARSE_WARNING_MESSAGES = {
 };
 const formatParseWarning = (warning) => PARSE_WARNING_MESSAGES[warning.code](warning);
 const formatParseWarnings = (warnings) => warnings.map(formatParseWarning);
-//#endregion
 export { formatParseWarning, formatParseWarnings };

package/dist/docx/parser.d.ts

@@ -3,7 +3,6 @@ import { DocxInput } from "../utils/docxInput.js";
 import { DocxUnzipOptions } from "./unzip.js";
 import { PreviewBudgetOverrides } from "./previewBudget.js";
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/parser.d.ts
 declare const DocxParseErrorBase: TaggedErrorClass<"DocxParseError">;
 /**
  * Progress callback for tracking parsing stages
@@ -86,5 +85,4 @@ export declare function getDocxSummary(buffer: ArrayBuffer): Promise<{
   mediaCount: number;
   variableCount: number;
 }>;
-//#endregion
 export {};

package/dist/docx/parser.js

@@ -44,7 +44,7 @@ import { FOLIO_XML_RESOURCE_LIMITS } from "./xmlResourceLimits.js";
 import { TaggedError, panic } from "better-result";
 import { PARSE_WARNING_CODES, setDocumentBodyComments } from "@stll/docx-core/model";
 import { isCommentExhausted } from "@stll/docx-core/ops";
-//#region src/docx/parser.ts
+// src/docx/parser.ts
 /**
 * Main Parser Orchestrator - Unified parseDocx function
 *
@@ -807,5 +807,4 @@ async function getDocxSummary(buffer) {
 		variableCount: variables.length
 	};
 }
-//#endregion
 export { DocxParseError, fullParseDocx, getDocxSummary, getDocxVariables, parseDocx, parseDocxWithPreviewBudget, quickParseDocx };

package/dist/docx/parserEnums.d.ts

@@ -1,5 +1,4 @@
 import * as v from "valibot";
-//#region src/docx/parserEnums.d.ts
 /**
  * Narrow a raw attribute string to a picklist member, or `undefined`
  * if the value isn't recognised. The cast lives once inside the
@@ -41,5 +40,4 @@ export declare const ImageVerticalAlignmentSchema: v.PicklistSchema<readonly ["t
 export declare const ImageWrapTextSchema: v.PicklistSchema<readonly ["bothSides", "left", "right", "largest"], undefined>;
 export declare const ShapeTypeSchema: v.PicklistSchema<readonly ["rect", "roundRect", "ellipse", "triangle", "rtTriangle", "parallelogram", "trapezoid", "pentagon", "hexagon", "heptagon", "octagon", "decagon", "dodecagon", "star4", "star5", "star6", "star7", "star8", "star10", "star12", "star16", "star24", "star32", "line", "straightConnector1", "bentConnector2", "bentConnector3", "bentConnector4", "bentConnector5", "curvedConnector2", "curvedConnector3", "curvedConnector4", "curvedConnector5", "rightArrow", "leftArrow", "upArrow", "downArrow", "leftRightArrow", "upDownArrow", "quadArrow", "leftRightUpArrow", "bentArrow", "uturnArrow", "leftUpArrow", "bentUpArrow", "curvedRightArrow", "curvedLeftArrow", "curvedUpArrow", "curvedDownArrow", "stripedRightArrow", "notchedRightArrow", "homePlate", "chevron", "rightArrowCallout", "downArrowCallout", "leftArrowCallout", "upArrowCallout", "leftRightArrowCallout", "quadArrowCallout", "circularArrow", "flowChartProcess", "flowChartAlternateProcess", "flowChartDecision", "flowChartInputOutput", "flowChartPredefinedProcess", "flowChartInternalStorage", "flowChartDocument", "flowChartMultidocument", "flowChartTerminator", "flowChartPreparation", "flowChartManualInput", "flowChartManualOperation", "flowChartConnector", "flowChartOffpageConnector", "flowChartPunchedCard", "flowChartPunchedTape", "flowChartSummingJunction", "flowChartOr", "flowChartCollate", "flowChartSort", "flowChartExtract", "flowChartMerge", "flowChartOnlineStorage", "flowChartDelay", "flowChartMagneticTape", "flowChartMagneticDisk", "flowChartMagneticDrum", "flowChartDisplay", "wedgeRectCallout", "wedgeRoundRectCallout", "wedgeEllipseCallout", "cloudCallout", "borderCallout1", "borderCallout2", "borderCallout3", "accentCallout1", "accentCallout2", "accentCallout3", "callout1", "callout2", "callout3", "accentBorderCallout1", "accentBorderCallout2", "accentBorderCallout3", "actionButtonBlank", "actionButtonHome", "actionButtonHelp", "actionButtonInformation", "actionButtonBackPrevious", "actionButtonForwardNext", "actionButtonBeginning", "actionButtonEnd", "actionButtonReturn", "actionButtonDocument", "actionButtonSound", "actionButtonMovie", "irregularSeal1", "irregularSeal2", "frame", "halfFrame", "corner", "diagStripe", "chord", "arc", "bracketPair", "bracePair", "leftBracket", "rightBracket", "leftBrace", "rightBrace", "can", "cube", "bevel", "donut", "noSmoking", "blockArc", "foldedCorner", "smileyFace", "heart", "lightningBolt", "sun", "moon", "cloud", "snip1Rect", "snip2SameRect", "snip2DiagRect", "snipRoundRect", "round1Rect", "round2SameRect", "round2DiagRect", "plaque", "teardrop", "mathPlus", "mathMinus", "mathMultiply", "mathDivide", "mathEqual", "mathNotEqual", "gear6", "gear9", "funnel", "pieWedge", "pie", "leftCircularArrow", "leftRightCircularArrow", "swooshArrow", "textBox"], undefined>;
 export declare const NumberFormatSchema: v.PicklistSchema<readonly ["decimal", "upperRoman", "lowerRoman", "upperLetter", "lowerLetter", "ordinal", "cardinalText", "ordinalText", "hex", "chicago", "ideographDigital", "japaneseCounting", "aiueo", "iroha", "decimalFullWidth", "decimalHalfWidth", "japaneseLegal", "japaneseDigitalTenThousand", "decimalEnclosedCircle", "decimalFullWidth2", "aiueoFullWidth", "irohaFullWidth", "decimalZero", "bullet", "ganada", "chosung", "decimalEnclosedFullstop", "decimalEnclosedParen", "decimalEnclosedCircleChinese", "ideographEnclosedCircle", "ideographTraditional", "ideographZodiac", "ideographZodiacTraditional", "taiwaneseCounting", "ideographLegalTraditional", "taiwaneseCountingThousand", "taiwaneseDigital", "chineseCounting", "chineseLegalSimplified", "chineseCountingThousand", "koreanDigital", "koreanCounting", "koreanLegal", "koreanDigital2", "vietnameseCounting", "russianLower", "russianUpper", "none", "numberInDash", "hebrew1", "hebrew2", "arabicAlpha", "arabicAbjad", "hindiVowels", "hindiConsonants", "hindiNumbers", "hindiCounting", "thaiLetters", "thaiNumbers", "thaiCounting", "bahtText", "dollarText", "custom"], undefined>;
-export declare const LevelSuffixSchema: v.PicklistSchema<readonly ["tab", "space", "nothing"], undefined>;
-//#endregion
+export declare const LevelSuffixSchema: v.PicklistSchema<readonly ["tab", "space", "nothing"], undefined>;

package/dist/docx/parserEnums.js

@@ -1,6 +1,6 @@
 import { CONDITIONAL_STYLE_TYPE_VALUES, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_HINT_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, NUMBER_FORMAT_VALUES, PARAGRAPH_ALIGNMENT_VALUES, POSITIONAL_TAB_ALIGNMENT_VALUES, POSITIONAL_TAB_LEADER_VALUES, POSITIONAL_TAB_RELATIVE_TO_VALUES, SDT_LOCK_VALUES, SHADING_PATTERN_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_JUSTIFICATION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_DIRECTION_VALUES, TEXT_EFFECT_VALUES, UNDERLINE_STYLE_VALUES } from "../types/documentEnumValues.js";
 import * as v from "valibot";
-//#region src/docx/parserEnums.ts
+// src/docx/parserEnums.ts
 /**
 * OOXML enum schemas for parser narrowing.
 *
@@ -68,5 +68,4 @@ const ImageWrapTextSchema = v.picklist(IMAGE_WRAP_TEXT_VALUES);
 const ShapeTypeSchema = v.picklist(SHAPE_TYPE_VALUES);
 const NumberFormatSchema = v.picklist(NUMBER_FORMAT_VALUES);
 const LevelSuffixSchema = v.picklist(LEVEL_SUFFIX_VALUES);
-//#endregion
 export { ConditionalStyleTypeSchema, EmphasisMarkSchema, FieldTypeSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, FontHintSchema, FontThemeSchema, FrameWrapSchema, FrameXAlignSchema, FrameYAlignSchema, HighlightColorSchema, ImageHorizontalAlignmentSchema, ImageHorizontalRelativeToSchema, ImageVerticalAlignmentSchema, ImageVerticalRelativeToSchema, ImageWrapTextSchema, LevelSuffixSchema, LineSpacingRuleSchema, NumberFormatSchema, ParagraphAlignmentSchema, PositionalTabAlignmentSchema, PositionalTabLeaderSchema, PositionalTabRelativeToSchema, SdtLockSchema, ShadingPatternSchema, ShapeTypeSchema, StyleTypeSchema, TabLeaderSchema, TabStopAlignmentSchema, TableAlignmentSchema, TableRowHeightRuleSchema, TableWidthTypeSchema, TextDirectionSchema, TextEffectSchema, UnderlineStyleSchema, narrowEnum };

package/dist/docx/preservedRunContent.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/preservedRunContent.d.ts
 /**
  * The visible text a preserved run child contributes, or `""` when it shows
  * nothing. Unknown markup contributes nothing on purpose: guessing at the text
@@ -27,5 +26,4 @@ export declare const preserveRunChild: (element: XmlElement) => document_d_expor
  */
 export declare const preservedInlineCapture: (xml: string) => document_d_exports.PreservedInline;
 /** Capture one unmodelled inline child of a paragraph or an inline wrapper. */
-export declare const preserveInlineChild: (element: XmlElement) => document_d_exports.PreservedInline;
-//#endregion
+export declare const preserveInlineChild: (element: XmlElement) => document_d_exports.PreservedInline;

package/dist/docx/preservedRunContent.js

@@ -1,7 +1,7 @@
 import { sliceText } from "../utils/sliceText.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
 import { findChildrenByLocalName, getChildElements, getLocalName, getTextContent } from "./xmlParser.js";
-//#region src/docx/preservedRunContent.ts
+// src/docx/preservedRunContent.ts
 /**
 * The run-level arm of the verbatim sink.
 *
@@ -118,5 +118,4 @@ const preserveInlineChild = (element) => {
 		})
 	};
 };
-//#endregion
 export { preserveInlineChild, preserveRunChild, preservedInlineCapture, preservedRunChildText };

package/dist/docx/previewBudget.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/previewBudget.d.ts
 type PreviewKindName = "vmlShape" | "wpGroup" | "smartArt";
 declare const PREVIEW_KINDS: {
   /** A VML shape folio renders rather than projects (`v:shape`, `v:rect`, ...). */
@@ -103,5 +102,4 @@ export declare const createPackagePreviewBudget: () => PackagePreviewBudget;
  * whose previews no package budget charges.
  */
 export declare const standalonePreviewLedger: () => PreviewLedger;
-//#endregion
 export {};

package/dist/docx/previewBudget.js

@@ -1,4 +1,4 @@
-//#region src/docx/previewBudget.ts
+// src/docx/previewBudget.ts
 /** Both SVG producers encode their drawing into the URL rather than base64. */
 const SVG_PREVIEW_DATA_URL_PREFIX = "data:image/svg+xml;charset=utf-8,";
 /**
@@ -109,5 +109,4 @@ const createPackagePreviewBudget = () => {
 * whose previews no package budget charges.
 */
 const standalonePreviewLedger = () => createPackagePreviewBudget().ledger;
-//#endregion
 export { createPackagePreviewBudget, standalonePreviewLedger };

package/dist/docx/propertyElementAttributes.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/propertyElementAttributes.d.ts
 /**
  * Which attributes of a property element the model has a field for.
  *
@@ -173,5 +172,4 @@ export declare const PROPERTY_ELEMENT_ATTRIBUTES: {
   };
 };
 /** Every attribute local name a table names, flattened, in field order. */
-export declare const modelledAttributeNames: (modelled: ModelledAttributes<string>) => readonly string[];
-//#endregion
+export declare const modelledAttributeNames: (modelled: ModelledAttributes<string>) => readonly string[];

package/dist/docx/propertyElementAttributes.js

@@ -1,4 +1,4 @@
-//#region src/docx/propertyElementAttributes.ts
+// src/docx/propertyElementAttributes.ts
 /**
 * `w:ind`. `hangingIndent` is the sign of `indentFirstLine` rather than a
 * value of its own, so both name the attribute pair that carries it.
@@ -110,5 +110,4 @@ const modelledAttributeNames = (modelled) => {
 	}
 	return names;
 };
-//#endregion
 export { BORDER_ATTRIBUTES, FRAME_ATTRIBUTES, INDENTATION_ATTRIBUTES, PROPERTY_ELEMENT_ATTRIBUTES, SHADING_ATTRIBUTES, SPACING_ATTRIBUTES, TAB_STOP_ATTRIBUTES, modelledAttributeNames };

package/dist/docx/rasterMime.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/rasterMime.d.ts
 declare const RASTER_SIGNATURES: readonly [{
   readonly mimeType: "image/png";
   readonly chunks: readonly [{
@@ -60,5 +59,4 @@ declare const RASTER_SIGNATURES: readonly [{
 export type RasterMimeType = (typeof RASTER_SIGNATURES)[number]["mimeType"];
 export declare const RASTER_MIME_TYPES: ReadonlySet<string>;
 export declare const detectRasterMimeType: (data: ArrayBuffer) => RasterMimeType | undefined;
-//#endregion
 export {};

package/dist/docx/rasterMime.js

@@ -1,4 +1,4 @@
-//#region src/docx/rasterMime.ts
+// src/docx/rasterMime.ts
 const RASTER_SIGNATURES = [
 	{
 		mimeType: "image/png",
@@ -112,5 +112,4 @@ const detectRasterMimeType = (data) => {
 	const bytes = new Uint8Array(data);
 	return RASTER_SIGNATURES.find(({ chunks }) => chunks.every(({ offset, bytes: signature }) => signature.every((byte, index) => bytes[offset + index] === byte)))?.mimeType;
 };
-//#endregion
 export { RASTER_MIME_TYPES, detectRasterMimeType };

package/dist/docx/relsParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import "../types/index.js";
-//#region src/docx/relsParser.d.ts
 /**
  * Relationship type constants for common types
  */
@@ -173,5 +172,4 @@ export declare function parsePackageRelationships(relsXml: string): document_d_e
  *
  * @param map - RelationshipMap to print
  */
-export declare function formatRelationships(map: document_d_exports.RelationshipMap): string;
-//#endregion
+export declare function formatRelationships(map: document_d_exports.RelationshipMap): string;

package/dist/docx/relsParser.js

@@ -1,6 +1,6 @@
 import { getAttribute, getChildElements, parseXmlDocument } from "./xmlParser.js";
 import { COMMENT_PART_RELATIONSHIPS } from "@stll/docx-core/model";
-//#region src/docx/relsParser.ts
+// src/docx/relsParser.ts
 /**
 * Relationship Parser
 *
@@ -276,5 +276,4 @@ function formatRelationships(map) {
 	}
 	return lines.join("\n");
 }
-//#endregion
 export { RELATIONSHIP_TYPES, filterByType, formatRelationships, getFooters, getHeaders, getHyperlinks, getImages, getRelationshipTypeName, isExternalHyperlink, isFooterRelationship, isHeaderRelationship, isImageRelationship, parseDocumentRelationships, parsePackageRelationships, parseRelationships, resolveRelationshipId, resolveRelationshipIdOfType, resolveRelativePath };

package/dist/docx/removeHeaderFooterParts.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { RemovedSectionReference } from "../internal/sectionEndpointResolution.js";
 import JSZip from "jszip";
-//#region src/docx/removeHeaderFooterParts.d.ts
 type RemoveResolvedHeaderFooterPartsOptions = {
   document: document_d_exports.Document;
   zip: JSZip;
@@ -10,5 +9,4 @@ type RemoveResolvedHeaderFooterPartsOptions = {
 };
 /** Remove only parts whose last selection was explicitly resolved out of the document. */
 export declare const removeResolvedHeaderFooterParts: ({ document, zip, removedReferences, compressionLevel }: RemoveResolvedHeaderFooterPartsOptions) => Promise<void>;
-//#endregion
 export {};

package/dist/docx/removeHeaderFooterParts.js

@@ -6,7 +6,7 @@ import { OFFICE_RELATIONSHIP_NAMESPACE_URIS, cloneElement, getAttribute, getLoca
 import { panic } from "better-result";
 import { OOXML_NS } from "@stll/docx-utils";
 import { writeZipPart } from "@stll/docx-core/zip";
-//#region src/docx/removeHeaderFooterParts.ts
+// src/docx/removeHeaderFooterParts.ts
 const DOCUMENT_RELS_PATH = "word/_rels/document.xml.rels";
 const officeRelationshipHasType = (type, kind) => [...OFFICE_RELATIONSHIP_NAMESPACE_URIS].some((namespace) => type === `${namespace}/${kind}`);
 const withoutChildren = (xml, remove) => {
@@ -95,5 +95,4 @@ const removeResolvedHeaderFooterParts = async ({ document, zip, removedReference
 		}
 	});
 };
-//#endregion
 export { removeResolvedHeaderFooterParts };

package/dist/docx/renderedPageBreakNormalization.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/renderedPageBreakNormalization.d.ts
 type NormalizeRenderedPageBreakHintsInput = {
   documentBody: document_d_exports.DocumentBody;
   headers?: Map<string, document_d_exports.HeaderFooter>;
@@ -8,5 +7,4 @@ type NormalizeRenderedPageBreakHintsInput = {
   endnotes?: readonly document_d_exports.Endnote[];
 };
 export declare const normalizeRenderedPageBreakHints: ({ documentBody, headers, footers, footnotes, endnotes }: NormalizeRenderedPageBreakHintsInput) => void;
-//#endregion
 export {};

package/dist/docx/renderedPageBreakNormalization.js

@@ -1,5 +1,5 @@
 import { visitDocxParagraphs } from "./paragraphTraversal.js";
-//#region src/docx/renderedPageBreakNormalization.ts
+// src/docx/renderedPageBreakNormalization.ts
 const normalizeRenderedPageBreakHints = ({ documentBody, headers, footers, footnotes, endnotes }) => {
 	visitDocxParagraphs({
 		documentBody,
@@ -55,5 +55,4 @@ const scanParagraphContent = (content, scan) => {
 	}
 	if (content.type === "complexField") return scan.sawRenderedPageBreak;
 };
-//#endregion
 export { normalizeRenderedPageBreakHints };

package/dist/docx/replyToComment.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/replyToComment.d.ts
 export type CreateCommentReplyInput = {
   author: string;
   text: string;
@@ -24,5 +23,4 @@ export declare const createReply: (comments: readonly document_d_exports.Comment
  * parent comment does not exist or cannot anchor a thread (see
  * {@link createReply}).
  */
-export declare const replyToComment: (doc: document_d_exports.Document, parentCommentId: number, input: CreateCommentReplyInput) => document_d_exports.Comment | null;
-//#endregion
+export declare const replyToComment: (doc: document_d_exports.Document, parentCommentId: number, input: CreateCommentReplyInput) => document_d_exports.Comment | null;

package/dist/docx/replyToComment.js

@@ -2,7 +2,7 @@ import { allocateCommentId, seedCommentIdAbove } from "../prosemirror/commentIdA
 import { generateHexId } from "../utils/hexId.js";
 import { commentTextParagraph } from "./commentTextParagraph.js";
 import { setDocumentBodyComments } from "@stll/docx-core/model";
-//#region src/docx/replyToComment.ts
+// src/docx/replyToComment.ts
 /**
 * Create a threaded reply to an existing comment.
 *
@@ -67,5 +67,4 @@ const replyToComment = (doc, parentCommentId, input) => {
 	setDocumentBodyComments(doc.package.document, [...comments, reply]);
 	return reply;
 };
-//#endregion
 export { createReply, replyToComment };

package/dist/docx/reviewHistoryNamespace.d.ts

@@ -1,3 +1 @@
-//#region src/docx/reviewHistoryNamespace.d.ts
-export declare const FOLIO_REVIEW_HISTORY_NAMESPACE = "urn:stella:folio:review-history:1";
-//#endregion
+export declare const FOLIO_REVIEW_HISTORY_NAMESPACE = "urn:stella:folio:review-history:1";

package/dist/docx/reviewHistoryNamespace.js

@@ -1,4 +1,3 @@
-//#region src/docx/reviewHistoryNamespace.ts
+// src/docx/reviewHistoryNamespace.ts
 const FOLIO_REVIEW_HISTORY_NAMESPACE = "urn:stella:folio:review-history:1";
-//#endregion
 export { FOLIO_REVIEW_HISTORY_NAMESPACE };

package/dist/docx/reviewResolutionProvenance.d.ts

@@ -2,7 +2,6 @@ import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
 import { TaggedErrorClass } from "better-result";
 import { CopyOriginAncestorList } from "@stll/docx-core/ops";
-//#region src/docx/reviewResolutionProvenance.d.ts
 type ResolutionJoins = NonNullable<document_d_exports.Insertion["resolutionJoins"]>;
 type BoundaryJoins = NonNullable<document_d_exports.RunPropertyChange["boundaryJoins"]>;
 export declare const isResolutionJoins: (value: unknown) => value is ResolutionJoins;
@@ -25,5 +24,4 @@ export declare const parseParagraphMarkResolutionJoin: (node: XmlElement) => Pic
 export declare const serializeParagraphMarkResolutionJoin: (mark: document_d_exports.ParagraphMarkChange) => string;
 /** Captured paragraph properties compose the same envelope into a parsed XML element. */
 export declare const paragraphMarkResolutionJoinAttributes: (mark: document_d_exports.ParagraphMarkChange) => Record<string, string>;
-//#endregion
 export {};