ooxml-core 0.19.0 → 0.20.0

package/dist/docx/index.mjs

@@ -31,7 +31,8 @@ function parseXml(xml, options = {}) {
     }).parseFromString(xml, "application/xml");
   } catch (error) {
     throw new Error(
-      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
     );
   }
   if (parseError || !parsed.documentElement)
@@ -509,7 +510,7 @@ var twipsFromPoints = (points) => roundTwips(points * 20);
 var signedTwipsFromPoints = (points) => roundSignedTwips(points * 20);
 var twipsFromPixels = (pixels) => roundTwips(pixels * 15);
 var signedTwipsFromPixels = (pixels) => roundSignedTwips(pixels * 15);
-var twipsFromInches = (inches) => roundTwips(inches * 1440);
+var twipsFromInches = (inches2) => roundTwips(inches2 * 1440);
 var halfPointsFromPoints = (points) => roundHalfPoints(points * 2);
 var eighthPointsFromPoints = (points) => roundEighthPoints(points * 8);
 var emuFromPixels = (pixels) => roundEmu(pixels * 9525);
@@ -3667,7 +3668,7 @@ var add = (parent, ...items) => {
   for (const item of items) parent.appendChild(item);
   return parent;
 };
-var emu2 = (px2) => String(Math.max(1, Math.round(px2 * EMU_PER_PIXEL)));
+var emu2 = (px3) => String(Math.max(1, Math.round(px3 * EMU_PER_PIXEL)));
 var descendants = (root, ns, local) => Array.from(root.getElementsByTagNameNS(ns, local));
 function paragraphsFor(doc, lines) {
   return (lines.length ? lines : [""]).map((line) => {
@@ -9814,4 +9815,268 @@ function sectionsOf(model) {
   ];
 }
 
-export { DEFAULT_STYLES_XML, DEFAULT_TABLE_BORDERS, DEFAULT_TOC_INSTRUCTION, DIAGRAM_GRAPHIC_URI, DocxModelValidationError, EMPTY_FIGURES_TEXT, EMPTY_TOC_TEXT, EMU_PER_INCH, EMU_PER_PIXEL, EMU_PER_POINT, LIGATURE_VALUES, PIXELS_PER_INCH, PROPERTY_FIELDS, ST_AlgClass, ST_AlgType, ST_AnnotationVMerge, ST_Border, ST_BrClear, ST_BrType, ST_CalendarType, ST_CaptionPos, ST_ChapterSep, ST_CharacterSpacing, ST_CombineBrackets, ST_ConformanceClass, ST_CryptProv, ST_Direction, ST_DisplacedByCustomXml, ST_DocGrid, ST_DocPartBehavior, ST_DocPartGallery, ST_DocPartType, ST_DocProtect, ST_DropCap, ST_EdGrp, ST_EdnPos, ST_Em, ST_FFTextType, ST_FldCharType, ST_FontFamily, ST_FrameLayout, ST_FrameScrollbar, ST_FtnEdn, ST_FtnPos, ST_HAnchor, ST_HdrFtr, ST_HeightRule, ST_HexColorAuto, ST_HighlightColor, ST_Hint, ST_InfoTextType, ST_Jc, ST_JcTable, ST_LevelSuffix, ST_LineNumberRestart, ST_LineSpacingRule, ST_Lock, ST_MailMergeDest, ST_MailMergeDocType, ST_MailMergeOdsoFMDFieldType, ST_MailMergeSourceType, ST_Merge, ST_MultiLevelType, ST_NumberFormat, ST_ObjectDrawAspect, ST_ObjectUpdateMode, ST_OnOff1, ST_PTabAlignment, ST_PTabLeader, ST_PTabRelativeTo, ST_PageBorderDisplay, ST_PageBorderOffset, ST_PageBorderZOrder, ST_PageOrientation, ST_Pitch, ST_Proof, ST_ProofErr, ST_RelFromH, ST_RelFromV, ST_RestartNumber, ST_RubyAlign, ST_SchemeColorVal, ST_SdtDateMappingType, ST_SectionMark, ST_Shd, ST_StyleSort, ST_StyleType, ST_TabJc, ST_TabTlc, ST_TargetScreenSz, ST_TblLayoutType, ST_TblOverlap, ST_TblStyleOverrideType, ST_TblWidth, ST_TextAlignment, ST_TextDirection, ST_TextEffect, ST_TextboxTightWrap, ST_Theme, ST_ThemeColor, ST_TrueFalse, ST_TrueFalseBlank, ST_Underline, ST_VAnchor, ST_VerticalAlignRun, ST_VerticalJc, ST_View, ST_WmlColorSchemeIndex, ST_Wrap, ST_XAlign, ST_YAlign, ST_Zoom, TWIPS_PER_INCH, TWIPS_PER_POINT, WORD_HIGHLIGHT_TOKENS, WORD_UNDERLINE_TOKENS, acceptAllRevisions, acceptRevision, alignFromJustification, applyThemeShade, applyThemeTint, assertValidDocumentModel, buildTableOfContents, captionParagraphs, changeColumnGap, changeColumnWidth, columnPreset, columnTextWidth, computeListLabels, createDocument, createListDefinition, dateFieldResult, datePicture, defaultStyleCatalogs, diagramColorTheme, diagramsIn, displayListLabel, documentStats, eighthPoints, eighthPointsFromPoints, eighthPointsToPoints, emu, emuFromPixels, emuToPixels, ensureListDefinition, enumValue, equalColumnDraft, fieldName, findRevision, findTableOfContents, formatListNumber, formatNoteNumber, formatWordDate, halfPoints, halfPointsFromPoints, halfPointsToPoints, headingLevel, headingListLevels, isCaptionOf, isHeadingListKind, isLigatures, isStAlgClass, isStAlgType, isStAnnotationVMerge, isStBorder, isStBrClear, isStBrType, isStCalendarType, isStCaptionPos, isStChapterSep, isStCharacterSpacing, isStCombineBrackets, isStConformanceClass, isStCryptProv, isStDirection, isStDisplacedByCustomXml, isStDocGrid, isStDocPartBehavior, isStDocPartGallery, isStDocPartType, isStDocProtect, isStDropCap, isStEdGrp, isStEdnPos, isStEm, isStFFTextType, isStFldCharType, isStFontFamily, isStFrameLayout, isStFrameScrollbar, isStFtnEdn, isStFtnPos, isStHAnchor, isStHdrFtr, isStHeightRule, isStHexColorAuto, isStHighlightColor, isStHint, isStInfoTextType, isStJc, isStJcTable, isStLevelSuffix, isStLineNumberRestart, isStLineSpacingRule, isStLock, isStMailMergeDest, isStMailMergeDocType, isStMailMergeOdsoFMDFieldType, isStMailMergeSourceType, isStMerge, isStMultiLevelType, isStNumberFormat, isStObjectDrawAspect, isStObjectUpdateMode, isStOnOff1, isStPTabAlignment, isStPTabLeader, isStPTabRelativeTo, isStPageBorderDisplay, isStPageBorderOffset, isStPageBorderZOrder, isStPageOrientation, isStPitch, isStProof, isStProofErr, isStRelFromH, isStRelFromV, isStRestartNumber, isStRubyAlign, isStSchemeColorVal, isStSdtDateMappingType, isStSectionMark, isStShd, isStStyleSort, isStStyleType, isStTabJc, isStTabTlc, isStTargetScreenSz, isStTblLayoutType, isStTblOverlap, isStTblStyleOverrideType, isStTblWidth, isStTextAlignment, isStTextDirection, isStTextEffect, isStTextboxTightWrap, isStTheme, isStThemeColor, isStTrueFalse, isStTrueFalseBlank, isStUnderline, isStVAnchor, isStVerticalAlignRun, isStVerticalJc, isStView, isStWmlColorSchemeIndex, isStWrap, isStXAlign, isStYAlign, isStZoom, isThemeColorToken, isValidLanguageTag, isWordHighlightToken, isWordUnderlineStyle, lineSpacingLabel, lineSpacingOptions, lineSpacingValue, linkStylesToList, listRevisions, loadDocx, numberNotesInOrder, onOffAttribute, onOffElement, parseColorSchemeMapping, parseEighthPoints, parseHalfPoints, parseHexColor, parseInteger, parseJustification, parseLineSpacingValue, parseNumberingCatalog, parseOnOff, parseParagraphStyleCatalog, parseRgbColor, parseRunStyleCatalog, parseSignedHalfPoints, parseSignedTwips, parseTableStyleCatalog, parseTextScale, parseTheme, parseTintShade, parseTwips, parseUnsignedInteger, plainText2 as plainText, readColumnDraft, rejectAllRevisions, rejectRevision, reportParseWarning, resolveCellVisuals, resolveDiagramColor, resolveNumberingLevel, resolveParagraphFormatting, resolveParagraphNumbering, resolveRunFormatting, resolveStyleNumbering, resolveTableStyleFormatting, resolveThemeColorReference, resolveThemeColorToken, roundEighthPoints, roundEmu, roundHalfPoints, roundSignedTwips, roundTwips, saveDocx, sectionLayoutJson, sectionsFromLayout, sectionsOf, signedTwips, signedTwipsFromPixels, signedTwipsFromPoints, tableOfFiguresInstruction, tocBookmarks, tocCaptionLabel, tocEntries, tocHyperlinks, tocLevels, twips, twipsFromInches, twipsFromPixels, twipsFromPoints, twipsToInches, twipsToPixels, twipsToPoints, unequalColumnPreset, universalMeasureToTwips, updateTableOfContents, validColumnDraft, validateDocumentModel, withParseWarnings, withTocBookmarks };
+// src/docx/attr-units.ts
+function twipsAttr(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? roundTwips(value) : void 0;
+}
+function signedTwipsAttr(value) {
+  return typeof value === "number" && Number.isFinite(value) ? roundSignedTwips(value) : void 0;
+}
+function paragraphTwipsFromAttrs(attrs) {
+  const result = {};
+  const spacingBefore = twipsAttr(attrs.spacingBeforeTwips);
+  const spacingAfter = twipsAttr(attrs.spacingAfterTwips);
+  const lineSpacing = signedTwipsAttr(attrs.lineSpacingTwips);
+  const left = signedTwipsAttr(attrs.indentLeftTwips);
+  const right = signedTwipsAttr(attrs.indentRightTwips);
+  const start = signedTwipsAttr(attrs.indentStartTwips);
+  const end = signedTwipsAttr(attrs.indentEndTwips);
+  const firstLine = twipsAttr(attrs.firstLineTwips);
+  const hanging = twipsAttr(attrs.hangingTwips);
+  if (spacingBefore !== void 0) result.spacingBeforeTwips = spacingBefore;
+  if (spacingAfter !== void 0) result.spacingAfterTwips = spacingAfter;
+  if (lineSpacing !== void 0) result.lineSpacingTwips = lineSpacing;
+  if (left !== void 0) result.indentLeftTwips = left;
+  if (right !== void 0) result.indentRightTwips = right;
+  if (start !== void 0) result.indentStartTwips = start;
+  if (end !== void 0) result.indentEndTwips = end;
+  if (firstLine !== void 0) result.firstLineTwips = firstLine;
+  if (hanging !== void 0) result.hangingTwips = hanging;
+  return result;
+}
+
+// src/docx/case-transform.ts
+var WORD = /[\p{L}\p{N}'’]/u;
+var swap = (char) => {
+  const upper = char.toLocaleUpperCase();
+  return char === upper ? char.toLocaleLowerCase() : upper;
+};
+function transformCase(text, mode, atSentenceStart = true) {
+  if (mode === "lower") return text.toLocaleLowerCase();
+  if (mode === "upper") return text.toLocaleUpperCase();
+  if (mode === "toggle") return [...text].map(swap).join("");
+  let start = mode === "sentence" ? atSentenceStart : true;
+  let previousWord = false;
+  let out = "";
+  for (const char of text) {
+    const isWord = WORD.test(char);
+    if (mode === "title") {
+      out += isWord && !previousWord ? char.toLocaleUpperCase() : char;
+    } else if (isWord && start) {
+      out += char.toLocaleUpperCase();
+      start = false;
+    } else {
+      out += isWord ? char.toLocaleLowerCase() : char;
+      if (/[.!?]/.test(char)) start = true;
+      else if (isWord) start = false;
+    }
+    previousWord = isWord;
+  }
+  return out;
+}
+
+// src/docx/section-edit.ts
+var px2 = twipsToPixels;
+function withSection(model, index, change) {
+  const sections = sectionsOf(model).map(
+    (section, position) => position === index ? change(structuredClone(section)) : section
+  );
+  const last = sections.at(-1);
+  return {
+    ...model,
+    sections,
+    page: {
+      width: px2(last.pageWidthTwips),
+      height: px2(last.pageHeightTwips),
+      marginTop: px2(last.marginTopTwips),
+      marginRight: px2(last.marginRightTwips),
+      marginBottom: px2(last.marginBottomTwips),
+      marginLeft: px2(last.marginLeftTwips)
+    }
+  };
+}
+var NORMAL_MARGIN = twips(1440);
+var MARGINS = {
+  normal: NORMAL_MARGIN,
+  narrow: twips(720),
+  wide: twips(2160)
+};
+function setMargins(model, index, preset) {
+  if (preset === "moderate")
+    return withSection(model, index, (section) => ({
+      ...section,
+      marginTopTwips: NORMAL_MARGIN,
+      marginBottomTwips: NORMAL_MARGIN,
+      marginLeftTwips: twips(1080),
+      marginRightTwips: twips(1080)
+    }));
+  const value = MARGINS[preset] ?? NORMAL_MARGIN;
+  return withSection(model, index, (section) => ({
+    ...section,
+    marginTopTwips: value,
+    marginRightTwips: value,
+    marginBottomTwips: value,
+    marginLeftTwips: value
+  }));
+}
+function setOrientation(model, index, orientation) {
+  return withSection(model, index, (section) => {
+    const { pageWidthTwips: width, pageHeightTwips: height } = section;
+    const long = width >= height ? width : height;
+    const short = width >= height ? height : width;
+    return {
+      ...section,
+      orientation,
+      pageWidthTwips: orientation === "landscape" ? long : short,
+      pageHeightTwips: orientation === "landscape" ? short : long
+    };
+  });
+}
+function setColumns(model, index, count) {
+  return withSection(model, index, (section) => ({
+    ...section,
+    columns: { count, spacingTwips: section.columns.spacingTwips ?? twips(720), equalWidth: true }
+  }));
+}
+function setVerticalAlign(model, index, verticalAlign) {
+  return withSection(model, index, (section) => {
+    const { verticalAlign: _previous, ...rest } = section;
+    return verticalAlign === "top" ? rest : { ...rest, verticalAlign };
+  });
+}
+function setTitlePage(model, index, titlePage) {
+  return withSection(model, index, (section) => ({ ...section, titlePage }));
+}
+function setPageNumbering(model, index, change) {
+  return withSection(model, index, (section) => {
+    const numbering = { ...section.pageNumbering };
+    if (change.format !== void 0) numbering.format = change.format;
+    if (change.restart === true) numbering.start = 1;
+    if (change.restart === false) delete numbering.start;
+    if (numbering.format === "decimal") delete numbering.format;
+    const { pageNumbering: _previous, ...rest } = section;
+    return Object.keys(numbering).length ? { ...rest, pageNumbering: numbering } : rest;
+  });
+}
+function setLineNumbering(model, index, mode) {
+  return withSection(model, index, (section) => {
+    const { lineNumbering: _on, lineNumberSettings: previous, ...rest } = section;
+    if (mode === "none") return rest;
+    return {
+      ...rest,
+      lineNumbering: true,
+      lineNumberSettings: {
+        countBy: previous?.countBy ?? 1,
+        start: previous?.start ?? 1,
+        restart: mode,
+        ...previous?.distanceTwips !== void 0 ? { distanceTwips: previous.distanceTwips } : {}
+      }
+    };
+  });
+}
+
+// src/docx/page-size.ts
+var PAGE_SIZES = {
+  letter: [12240, 15840],
+  legal: [12240, 20160],
+  tabloid: [15840, 24480],
+  executive: [10440, 15120],
+  a3: [16838, 23811],
+  a4: [11906, 16838],
+  a5: [8391, 11906],
+  b5: [10319, 14570]
+};
+var PAGE_SIZE_OPTIONS = [
+  ["letter", "Letter"],
+  ["legal", "Legal"],
+  ["tabloid", "Tabloid"],
+  ["executive", "Executive"],
+  ["a3", "A3"],
+  ["a4", "A4"],
+  ["a5", "A5"],
+  ["b5", "B5 (JIS)"]
+];
+function setPageSize(model, index, preset) {
+  const size = PAGE_SIZES[preset];
+  if (!size) return model;
+  return withSection(model, index, (section) => {
+    const [short, long] = size;
+    const landscape = section.orientation === "landscape";
+    return {
+      ...section,
+      pageWidthTwips: twips(landscape ? long : short),
+      pageHeightTwips: twips(landscape ? short : long)
+    };
+  });
+}
+function pageSizeOf(section) {
+  const a = Math.min(section.pageWidthTwips, section.pageHeightTwips);
+  const b = Math.max(section.pageWidthTwips, section.pageHeightTwips);
+  for (const [key, [short, long]] of Object.entries(PAGE_SIZES))
+    if (Math.abs(short - a) <= 2 && Math.abs(long - b) <= 2) return key;
+  return null;
+}
+
+// src/docx/page-setup-model.ts
+var TWIPS_PER_INCH2 = 1440;
+var MAX_PAGE_INCHES = 22;
+var MIN_TEXT_INCHES = 0.5;
+var inches = (value) => Math.round(value / TWIPS_PER_INCH2 * 1e3) / 1e3;
+function readPageSetup(section) {
+  const short = Math.min(section.pageWidthTwips, section.pageHeightTwips);
+  const long = Math.max(section.pageWidthTwips, section.pageHeightTwips);
+  return {
+    topIn: inches(section.marginTopTwips),
+    bottomIn: inches(section.marginBottomTwips),
+    leftIn: inches(section.marginLeftTwips),
+    rightIn: inches(section.marginRightTwips),
+    gutterIn: inches(section.gutterTwips ?? 0),
+    headerIn: inches(section.headerDistanceTwips ?? 720),
+    footerIn: inches(section.footerDistanceTwips ?? 720),
+    orientation: section.orientation,
+    widthIn: inches(short),
+    heightIn: inches(long)
+  };
+}
+function validatePageSetup(values) {
+  const margins = [values.topIn, values.bottomIn, values.leftIn, values.rightIn, values.gutterIn];
+  const measures = [...margins, values.headerIn, values.footerIn];
+  if (measures.some((value) => !Number.isFinite(value) || value < 0 || value > MAX_PAGE_INCHES))
+    return "range";
+  if (![values.widthIn, values.heightIn].every((v) => v > 0 && v <= MAX_PAGE_INCHES))
+    return "range";
+  const short = Math.min(values.widthIn, values.heightIn);
+  const long = Math.max(values.widthIn, values.heightIn);
+  const [width, height] = values.orientation === "landscape" ? [long, short] : [short, long];
+  if (width - values.leftIn - values.rightIn - values.gutterIn < MIN_TEXT_INCHES) return "width";
+  if (height - values.topIn - values.bottomIn < MIN_TEXT_INCHES) return "height";
+  return null;
+}
+var toTwips = (value) => Math.round(value * TWIPS_PER_INCH2);
+function applyPageSetup(model, index, values) {
+  if (validatePageSetup(values)) return model;
+  const short = Math.min(values.widthIn, values.heightIn);
+  const long = Math.max(values.widthIn, values.heightIn);
+  const landscape = values.orientation === "landscape";
+  return withSection(model, index, (section) => ({
+    ...section,
+    orientation: values.orientation,
+    pageWidthTwips: twips(toTwips(landscape ? long : short)),
+    pageHeightTwips: twips(toTwips(landscape ? short : long)),
+    marginTopTwips: signedTwips(toTwips(values.topIn)),
+    marginBottomTwips: signedTwips(toTwips(values.bottomIn)),
+    marginLeftTwips: twips(toTwips(values.leftIn)),
+    marginRightTwips: twips(toTwips(values.rightIn)),
+    gutterTwips: twips(toTwips(values.gutterIn)),
+    headerDistanceTwips: twips(toTwips(values.headerIn)),
+    footerDistanceTwips: twips(toTwips(values.footerIn))
+  }));
+}
+function presetOf(values) {
+  return pageSizeOf({
+    pageWidthTwips: twips(toTwips(values.widthIn)),
+    pageHeightTwips: twips(toTwips(values.heightIn))
+  });
+}
+
+export { DEFAULT_STYLES_XML, DEFAULT_TABLE_BORDERS, DEFAULT_TOC_INSTRUCTION, DIAGRAM_GRAPHIC_URI, DocxModelValidationError, EMPTY_FIGURES_TEXT, EMPTY_TOC_TEXT, EMU_PER_INCH, EMU_PER_PIXEL, EMU_PER_POINT, LIGATURE_VALUES, PAGE_SIZES, PAGE_SIZE_OPTIONS, PIXELS_PER_INCH, PROPERTY_FIELDS, ST_AlgClass, ST_AlgType, ST_AnnotationVMerge, ST_Border, ST_BrClear, ST_BrType, ST_CalendarType, ST_CaptionPos, ST_ChapterSep, ST_CharacterSpacing, ST_CombineBrackets, ST_ConformanceClass, ST_CryptProv, ST_Direction, ST_DisplacedByCustomXml, ST_DocGrid, ST_DocPartBehavior, ST_DocPartGallery, ST_DocPartType, ST_DocProtect, ST_DropCap, ST_EdGrp, ST_EdnPos, ST_Em, ST_FFTextType, ST_FldCharType, ST_FontFamily, ST_FrameLayout, ST_FrameScrollbar, ST_FtnEdn, ST_FtnPos, ST_HAnchor, ST_HdrFtr, ST_HeightRule, ST_HexColorAuto, ST_HighlightColor, ST_Hint, ST_InfoTextType, ST_Jc, ST_JcTable, ST_LevelSuffix, ST_LineNumberRestart, ST_LineSpacingRule, ST_Lock, ST_MailMergeDest, ST_MailMergeDocType, ST_MailMergeOdsoFMDFieldType, ST_MailMergeSourceType, ST_Merge, ST_MultiLevelType, ST_NumberFormat, ST_ObjectDrawAspect, ST_ObjectUpdateMode, ST_OnOff1, ST_PTabAlignment, ST_PTabLeader, ST_PTabRelativeTo, ST_PageBorderDisplay, ST_PageBorderOffset, ST_PageBorderZOrder, ST_PageOrientation, ST_Pitch, ST_Proof, ST_ProofErr, ST_RelFromH, ST_RelFromV, ST_RestartNumber, ST_RubyAlign, ST_SchemeColorVal, ST_SdtDateMappingType, ST_SectionMark, ST_Shd, ST_StyleSort, ST_StyleType, ST_TabJc, ST_TabTlc, ST_TargetScreenSz, ST_TblLayoutType, ST_TblOverlap, ST_TblStyleOverrideType, ST_TblWidth, ST_TextAlignment, ST_TextDirection, ST_TextEffect, ST_TextboxTightWrap, ST_Theme, ST_ThemeColor, ST_TrueFalse, ST_TrueFalseBlank, ST_Underline, ST_VAnchor, ST_VerticalAlignRun, ST_VerticalJc, ST_View, ST_WmlColorSchemeIndex, ST_Wrap, ST_XAlign, ST_YAlign, ST_Zoom, TWIPS_PER_INCH, TWIPS_PER_POINT, WORD, WORD_HIGHLIGHT_TOKENS, WORD_UNDERLINE_TOKENS, acceptAllRevisions, acceptRevision, alignFromJustification, applyPageSetup, applyThemeShade, applyThemeTint, assertValidDocumentModel, buildTableOfContents, captionParagraphs, changeColumnGap, changeColumnWidth, columnPreset, columnTextWidth, computeListLabels, createDocument, createListDefinition, dateFieldResult, datePicture, defaultStyleCatalogs, diagramColorTheme, diagramsIn, displayListLabel, documentStats, eighthPoints, eighthPointsFromPoints, eighthPointsToPoints, emu, emuFromPixels, emuToPixels, ensureListDefinition, enumValue, equalColumnDraft, fieldName, findRevision, findTableOfContents, formatListNumber, formatNoteNumber, formatWordDate, halfPoints, halfPointsFromPoints, halfPointsToPoints, headingLevel, headingListLevels, isCaptionOf, isHeadingListKind, isLigatures, isStAlgClass, isStAlgType, isStAnnotationVMerge, isStBorder, isStBrClear, isStBrType, isStCalendarType, isStCaptionPos, isStChapterSep, isStCharacterSpacing, isStCombineBrackets, isStConformanceClass, isStCryptProv, isStDirection, isStDisplacedByCustomXml, isStDocGrid, isStDocPartBehavior, isStDocPartGallery, isStDocPartType, isStDocProtect, isStDropCap, isStEdGrp, isStEdnPos, isStEm, isStFFTextType, isStFldCharType, isStFontFamily, isStFrameLayout, isStFrameScrollbar, isStFtnEdn, isStFtnPos, isStHAnchor, isStHdrFtr, isStHeightRule, isStHexColorAuto, isStHighlightColor, isStHint, isStInfoTextType, isStJc, isStJcTable, isStLevelSuffix, isStLineNumberRestart, isStLineSpacingRule, isStLock, isStMailMergeDest, isStMailMergeDocType, isStMailMergeOdsoFMDFieldType, isStMailMergeSourceType, isStMerge, isStMultiLevelType, isStNumberFormat, isStObjectDrawAspect, isStObjectUpdateMode, isStOnOff1, isStPTabAlignment, isStPTabLeader, isStPTabRelativeTo, isStPageBorderDisplay, isStPageBorderOffset, isStPageBorderZOrder, isStPageOrientation, isStPitch, isStProof, isStProofErr, isStRelFromH, isStRelFromV, isStRestartNumber, isStRubyAlign, isStSchemeColorVal, isStSdtDateMappingType, isStSectionMark, isStShd, isStStyleSort, isStStyleType, isStTabJc, isStTabTlc, isStTargetScreenSz, isStTblLayoutType, isStTblOverlap, isStTblStyleOverrideType, isStTblWidth, isStTextAlignment, isStTextDirection, isStTextEffect, isStTextboxTightWrap, isStTheme, isStThemeColor, isStTrueFalse, isStTrueFalseBlank, isStUnderline, isStVAnchor, isStVerticalAlignRun, isStVerticalJc, isStView, isStWmlColorSchemeIndex, isStWrap, isStXAlign, isStYAlign, isStZoom, isThemeColorToken, isValidLanguageTag, isWordHighlightToken, isWordUnderlineStyle, lineSpacingLabel, lineSpacingOptions, lineSpacingValue, linkStylesToList, listRevisions, loadDocx, numberNotesInOrder, onOffAttribute, onOffElement, pageSizeOf, paragraphTwipsFromAttrs, parseColorSchemeMapping, parseEighthPoints, parseHalfPoints, parseHexColor, parseInteger, parseJustification, parseLineSpacingValue, parseNumberingCatalog, parseOnOff, parseParagraphStyleCatalog, parseRgbColor, parseRunStyleCatalog, parseSignedHalfPoints, parseSignedTwips, parseTableStyleCatalog, parseTextScale, parseTheme, parseTintShade, parseTwips, parseUnsignedInteger, plainText2 as plainText, presetOf, readColumnDraft, readPageSetup, rejectAllRevisions, rejectRevision, reportParseWarning, resolveCellVisuals, resolveDiagramColor, resolveNumberingLevel, resolveParagraphFormatting, resolveParagraphNumbering, resolveRunFormatting, resolveStyleNumbering, resolveTableStyleFormatting, resolveThemeColorReference, resolveThemeColorToken, roundEighthPoints, roundEmu, roundHalfPoints, roundSignedTwips, roundTwips, saveDocx, sectionLayoutJson, sectionsFromLayout, sectionsOf, setColumns, setLineNumbering, setMargins, setOrientation, setPageNumbering, setPageSize, setTitlePage, setVerticalAlign, signedTwips, signedTwipsAttr, signedTwipsFromPixels, signedTwipsFromPoints, tableOfFiguresInstruction, tocBookmarks, tocCaptionLabel, tocEntries, tocHyperlinks, tocLevels, transformCase, twips, twipsAttr, twipsFromInches, twipsFromPixels, twipsFromPoints, twipsToInches, twipsToPixels, twipsToPoints, unequalColumnPreset, universalMeasureToTwips, updateTableOfContents, validColumnDraft, validateDocumentModel, validatePageSetup, withParseWarnings, withSection, withTocBookmarks };

package/dist/docx/layout/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,aAAa,EAKb,MAAM,aAAa,CAAC;AAmBrB,OAAO,KAAK,EAEX,mBAAmB,EAMnB,MAAM,YAAY,CAAC;AA2BpB,oFAAoF;AACpF,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe,GACxC,mBAAmB,CA8PrB"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,aAAa,EAIb,MAAM,aAAa,CAAC;AAmBrB,OAAO,KAAK,EAEX,mBAAmB,EAKnB,MAAM,YAAY,CAAC;AA2BpB,oFAAoF;AACpF,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe,GACxC,mBAAmB,CA8PrB"}

package/dist/docx/layout/table-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-layout.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/table-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAmB,cAAc,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAG1E,MAAM,WAAW,SAAS;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAC;IAC9B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAC9B,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAC/B,KAAK,SAAI,EACT,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAyBnD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACxB,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAC/B,SAAS,CAAC,EAAE,kBAAkB,EAAE,EAAE,GAChC,SAAS,CAyCX;AAsDD,MAAM,WAAW,QAAQ;IACxB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,CAoB9E"}
+{"version":3,"file":"table-layout.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/table-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAG1E,MAAM,WAAW,SAAS;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAC;IAC9B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAC9B,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAC/B,KAAK,SAAI,EACT,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAyBnD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACxB,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAC/B,SAAS,CAAC,EAAE,kBAAkB,EAAE,EAAE,GAChC,SAAS,CAyCX;AAsDD,MAAM,WAAW,QAAQ;IACxB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,CAoB9E"}

package/dist/docx/load/index.cjs

@@ -1879,7 +1879,8 @@ function parseXml(xml, options = {}) {
     }).parseFromString(xml, "application/xml");
   } catch (error) {
     throw new Error(
-      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
     );
   }
   if (parseError || !parsed.documentElement)

package/dist/docx/load/index.mjs

@@ -1873,7 +1873,8 @@ function parseXml(xml, options = {}) {
     }).parseFromString(xml, "application/xml");
   } catch (error) {
     throw new Error(
-      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
     );
   }
   if (parseError || !parsed.documentElement)

package/dist/docx/page-setup-model.d.ts

@@ -0,0 +1,29 @@
+import type { DocumentModel } from './model.js';
+import type { SectionProperties } from './section-model.js';
+/** What Word's Page Setup dialog edits for one section, in inches. */
+export interface PageSetupValues {
+    topIn: number;
+    bottomIn: number;
+    leftIn: number;
+    rightIn: number;
+    gutterIn: number;
+    headerIn: number;
+    footerIn: number;
+    orientation: 'portrait' | 'landscape';
+    /** Portrait width and height; landscape swaps them when applied. */
+    widthIn: number;
+    heightIn: number;
+}
+export type PageSetupProblem = 'range' | 'width' | 'height';
+/** The section's current settings, with the paper always in portrait terms. */
+export declare function readPageSetup(section: SectionProperties): PageSetupValues;
+/**
+ * Checks the values as Word does: every measure in range, and margins that leave room for text
+ * (at least half an inch each way). Returns the first problem, or null when they can be applied.
+ */
+export declare function validatePageSetup(values: PageSetupValues): PageSetupProblem | null;
+/** Applies validated values to section `index`; invalid values leave the model as it was. */
+export declare function applyPageSetup(model: DocumentModel, index: number, values: PageSetupValues): DocumentModel;
+/** The paper-size preset a set of values matches, or null for a custom size. */
+export declare function presetOf(values: PageSetupValues): string | null;
+//# sourceMappingURL=page-setup-model.d.ts.map

package/dist/docx/page-setup-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-setup-model.d.ts","sourceRoot":"","sources":["../../src/docx/page-setup-model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,GAAG,WAAW,CAAC;IACtC,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAO5D,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,eAAe,CAezE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,GAAG,IAAI,CAalF;AAID,6FAA6F;AAC7F,wBAAgB,cAAc,CAC7B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,GACrB,aAAa,CAkBf;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAK/D"}

package/dist/docx/page-size.d.ts

@@ -0,0 +1,11 @@
+import type { DocumentModel } from './model.js';
+import type { SectionProperties } from './section-model.js';
+/** Word's Layout > Size presets, portrait width by height in twips (1/1440 inch). */
+export declare const PAGE_SIZES: Record<string, readonly [width: number, height: number]>;
+/** English labels for the size list; paper names are proper nouns and stay as they are. */
+export declare const PAGE_SIZE_OPTIONS: Array<[string, string]>;
+/** Sets a section's paper size, keeping its orientation (landscape swaps width and height). */
+export declare function setPageSize(model: DocumentModel, index: number, preset: string): DocumentModel;
+/** The preset a section's paper matches in either orientation, or null for a custom size. */
+export declare function pageSizeOf(section: SectionProperties): string | null;
+//# sourceMappingURL=page-size.d.ts.map

package/dist/docx/page-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-size.d.ts","sourceRoot":"","sources":["../../src/docx/page-size.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,qFAAqF;AACrF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAS/E,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CASrD,CAAC;AAEF,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAY9F;AAED,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAMpE"}

package/dist/docx/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/docx/parse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAS,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA+BvE,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;CACpB;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;IAC3E,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACvC,CAAC,CAgLD;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAUvF"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/docx/parse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAS,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA8BvE,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;CACpB;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;IAC3E,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACvC,CAAC,CAgLD;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAUvF"}

package/dist/docx/section-edit.d.ts

@@ -0,0 +1,19 @@
+import type { DocumentModel } from './model.js';
+import type { SectionProperties } from './section-model.js';
+/** Returns `model` with section `index` changed; the last section also drives `model.page`. */
+export declare function withSection(model: DocumentModel, index: number, change: (section: SectionProperties) => SectionProperties): DocumentModel;
+export declare function setMargins(model: DocumentModel, index: number, preset: string): DocumentModel;
+export declare function setOrientation(model: DocumentModel, index: number, orientation: 'portrait' | 'landscape'): DocumentModel;
+export declare function setColumns(model: DocumentModel, index: number, count: number): DocumentModel;
+/** Layout > Page Setup > Vertical alignment for one section. */
+export declare function setVerticalAlign(model: DocumentModel, index: number, verticalAlign: NonNullable<SectionProperties['verticalAlign']>): DocumentModel;
+/** Header & Footer > Different First Page for one section. */
+export declare function setTitlePage(model: DocumentModel, index: number, titlePage: boolean): DocumentModel;
+/** Page number format, and whether numbering continues or restarts at 1 in this section. */
+export declare function setPageNumbering(model: DocumentModel, index: number, change: {
+    format?: NonNullable<SectionProperties['pageNumbering']>['format'];
+    restart?: boolean;
+}): DocumentModel;
+/** Layout > Line Numbers: off, or on with the restart rule; other line-number values are kept. */
+export declare function setLineNumbering(model: DocumentModel, index: number, mode: 'none' | 'continuous' | 'newPage' | 'newSection'): DocumentModel;
+//# sourceMappingURL=section-edit.d.ts.map

package/dist/docx/section-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-edit.d.ts","sourceRoot":"","sources":["../../src/docx/section-edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,+FAA+F;AAC/F,wBAAgB,WAAW,CAC1B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,iBAAiB,GACvD,aAAa,CAiBf;AASD,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAiB7F;AAED,wBAAgB,cAAc,CAC7B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,UAAU,GAAG,WAAW,GACnC,aAAa,CAYf;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAK5F;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,WAAW,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,GAC5D,aAAa,CAKf;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAC3B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,GAChB,aAAa,CAEf;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/F,aAAa,CAUf;AAED,kGAAkG;AAClG,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,GACpD,aAAa,CAef"}

package/dist/docx/tab-stops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tab-stops.d.ts","sourceRoot":"","sources":["../../src/docx/tab-stops.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAKrD,OAAO,EAMN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,MAAM,UAAU,CAAC;AAElB,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,EAAE,CAUrE;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAC5B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,EACpB,IAAI,CAAC,EAAE,SAAS,GACd,IAAI,CAcN;AA0CD,gDAAgD;AAChD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAEhE"}
+{"version":3,"file":"tab-stops.d.ts","sourceRoot":"","sources":["../../src/docx/tab-stops.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAKrD,OAAO,EAKN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,MAAM,UAAU,CAAC;AAElB,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,EAAE,CAUrE;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAC5B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,EACpB,IAAI,CAAC,EAAE,SAAS,GACd,IAAI,CAcN;AA0CD,gDAAgD;AAChD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAEhE"}

package/dist/docx/ui/backstage-focus.d.ts

@@ -0,0 +1,6 @@
+/** Make the rest of the editor inert while the File view is open and restore its opening control. */
+export declare function backstageFocus(element: HTMLElement): {
+    open(): void;
+    close(): void;
+};
+//# sourceMappingURL=backstage-focus.d.ts.map

package/dist/docx/ui/backstage-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backstage-focus.d.ts","sourceRoot":"","sources":["../../../src/docx/ui/backstage-focus.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW;IAKjD,IAAI;IAUJ,KAAK;EAON"}

package/dist/docx/ui/break-note-schema.d.ts

@@ -0,0 +1,11 @@
+import type { NodeSpec } from 'prosemirror-model';
+/** A visible, editable page or column break marker (`w:br` type page/column). */
+export declare const pageBreakNodeSpec: NodeSpec;
+/** A read-only footnote/endnote reference mark; its number is derived from document order. */
+export declare const noteReferenceNodeSpec: NodeSpec;
+/**
+ * A complex field's structural run: a `w:fldChar` marker (begin/separate/end) or its instruction
+ * text (`code`). Invisible while editing; its run formatting rides in `format` like note references.
+ */
+export declare const fieldMarkerNodeSpec: NodeSpec;
+//# sourceMappingURL=break-note-schema.d.ts.map

package/dist/docx/ui/break-note-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"break-note-schema.d.ts","sourceRoot":"","sources":["../../../src/docx/ui/break-note-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,EAAE,QAoB/B,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,EAAE,QAoCnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAyBjC,CAAC"}

package/dist/docx/ui/collaboration-authority.d.ts

@@ -0,0 +1,31 @@
+import type { Node as ProseMirrorNode } from 'prosemirror-model';
+import { type StepBatch } from './collaboration-protocol.js';
+export interface CollaborationAuthorityConfig {
+    sessionId: string;
+    doc: ProseMirrorNode;
+    version?: number;
+    stepHistoryLimit?: number;
+}
+export type AuthorityResult = {
+    status: 'accepted' | 'duplicate';
+    batch: StepBatch;
+} | {
+    status: 'rejected';
+    reason: string;
+};
+/** Small in-memory reference authority. A host should replace it with its server and persistence. */
+export declare class CollaborationAuthority {
+    readonly sessionId: string;
+    private readonly schema;
+    private readonly stepHistoryLimit;
+    private version;
+    private documents;
+    private records;
+    private readonly requests;
+    constructor(config: CollaborationAuthorityConfig);
+    get currentVersion(): number;
+    get doc(): ProseMirrorNode;
+    submit(input: unknown): AuthorityResult;
+    private pruneHistory;
+}
+//# sourceMappingURL=collaboration-authority.d.ts.map

package/dist/docx/ui/collaboration-authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration-authority.d.ts","sourceRoot":"","sources":["../../../src/docx/ui/collaboration-authority.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,eAAe,EAAU,MAAM,mBAAmB,CAAC;AAIzE,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAEtF,MAAM,WAAW,4BAA4B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,eAAe,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,eAAe,GACxB;IAAE,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACtD;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAkB1C,qGAAqG;AACrG,qBAAa,sBAAsB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwD;IAEjF,YAAY,MAAM,EAAE,4BAA4B,EAW/C;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,GAAG,IAAI,eAAe,CAEzB;IAED,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CA2EtC;IAED,OAAO,CAAC,YAAY;CAOpB"}

package/dist/docx/ui/collaboration-identity.d.ts

@@ -0,0 +1,8 @@
+import type { EditorState, Transaction } from 'prosemirror-state';
+/** Generates collision-resistant document IDs within one unique client session. */
+export declare function createCollaborationIdGenerator(clientId: string): (kind: string) => string;
+/** Repairs missing or duplicate block IDs on local transactions. */
+export declare function repairCollaborativeDocumentIds(state: EditorState, clientId: string, idGenerator?: (kind: string) => string): Transaction | null;
+/** @deprecated Use repairCollaborativeDocumentIds to include table IDs as well. */
+export declare const repairCollaborativeParagraphIds: typeof repairCollaborativeDocumentIds;
+//# sourceMappingURL=collaboration-identity.d.ts.map

package/dist/docx/ui/collaboration-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration-identity.d.ts","sourceRoot":"","sources":["../../../src/docx/ui/collaboration-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGlE,mFAAmF;AACnF,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAGzF;AAED,oEAAoE;AACpE,wBAAgB,8BAA8B,CAC7C,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,UAT6D,MAAM,KAAK,MAS7B,GACpD,WAAW,GAAG,IAAI,CAwBpB;AAED,mFAAmF;AACnF,eAAO,MAAM,+BAA+B,uCAAiC,CAAC"}

package/dist/docx/ui/collaboration-protocol.d.ts

@@ -0,0 +1,25 @@
+import type { Schema } from 'prosemirror-model';
+import { Step } from 'prosemirror-transform';
+export interface CollaborationConfig {
+    sessionId: string;
+    clientId: string;
+    version?: number;
+}
+/** Version is the authority version immediately before applying these steps. */
+export interface StepBatch {
+    protocol: 1;
+    sessionId: string;
+    batchId: string;
+    version: number;
+    clientId: string;
+    steps: readonly unknown[];
+}
+export type ParsedBatch = {
+    batch: StepBatch;
+    steps: Step[];
+    fingerprint: string;
+};
+/** Freezing comes from the shared collab area. */
+export declare const freezeBatch: (batch: StepBatch) => StepBatch;
+export declare function parseBatch(value: unknown, schema: Schema): ParsedBatch | string;
+//# sourceMappingURL=collaboration-protocol.d.ts.map

package/dist/docx/ui/collaboration-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration-protocol.d.ts","sourceRoot":"","sources":["../../../src/docx/ui/collaboration-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAG7C,MAAM,WAAW,mBAAmB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACzB,QAAQ,EAAE,CAAC,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,kDAAkD;AAClD,eAAO,MAAM,WAAW,UAAW,SAAS,KAAG,SAA8B,CAAC;AAE9E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CA+B/E"}

package/dist/docx/ui/collaboration.d.ts

@@ -0,0 +1,30 @@
+import { Plugin, type EditorState, type Transaction } from 'prosemirror-state';
+import { type CollaborationConfig, type StepBatch } from './collaboration-protocol.js';
+export type { CollaborationConfig, StepBatch } from './collaboration-protocol.js';
+export { CollaborationAuthority } from './collaboration-authority.js';
+export type { CollaborationAuthorityConfig, AuthorityResult } from './collaboration-authority.js';
+export type ClientReceiveResult = {
+    status: 'applied';
+    transaction: Transaction;
+} | {
+    status: 'duplicate' | 'stale' | 'out-of-order' | 'wrong-session' | 'invalid';
+    reason?: string;
+};
+/** Client-side plugin and transport helpers. It does not open a network connection. */
+export declare class CollaborationClient {
+    readonly plugin: Plugin;
+    readonly sessionId: string;
+    readonly clientId: string;
+    private readonly config;
+    private sequence;
+    private pending?;
+    private readonly received;
+    constructor(config: CollaborationConfig);
+    get hasPendingAck(): boolean;
+    pendingStepCount(state: EditorState): number;
+    /** Returns the same envelope until acknowledged, so transport retries are idempotent. */
+    createPendingBatch(state: EditorState): StepBatch | null;
+    /** Converts one ordered authority batch into the transaction hosts should dispatch. */
+    receive(state: EditorState, input: unknown): ClientReceiveResult;
+}
+//# sourceMappingURL=collaboration.d.ts.map

package/dist/docx/ui/collaboration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration.d.ts","sourceRoot":"","sources":["../../../src/docx/ui/collaboration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE/E,OAAO,EAGN,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EAAE,4BAA4B,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAElG,MAAM,MAAM,mBAAmB,GAC5B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,GAC/C;IACA,MAAM,EAAE,WAAW,GAAG,OAAO,GAAG,cAAc,GAAG,eAAe,GAAG,SAAS,CAAC;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAmBL,uFAAuF;AACvF,qBAAa,mBAAmB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAAC,CAAwB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IAErE,YAAY,MAAM,EAAE,mBAAmB,EAStC;IAED,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE3C;IAED,yFAAyF;IACzF,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAUvD;IAED,uFAAuF;IACvF,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAyC/D;CACD"}

package/dist/docx/ui/defined.d.ts

@@ -0,0 +1,3 @@
+/** Narrows a value the caller knows is present (an internal invariant), failing loudly with context if not. */
+export declare function expectDefined<T>(value: T | null | undefined, context: string): T;
+//# sourceMappingURL=defined.d.ts.map

package/dist/docx/ui/defined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defined.d.ts","sourceRoot":"","sources":["../../../src/docx/ui/defined.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAGhF"}

package/dist/docx/ui/dirty-state.d.ts

@@ -0,0 +1,9 @@
+/** Unsaved-changes flag behind `element.dirty`; reports only real transitions. */
+export declare class DirtyState {
+    private readonly changed;
+    private value;
+    constructor(changed: (dirty: boolean) => void);
+    get dirty(): boolean;
+    set(dirty: boolean): void;
+}
+//# sourceMappingURL=dirty-state.d.ts.map

package/dist/docx/ui/dirty-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirty-state.d.ts","sourceRoot":"","sources":["../../../src/docx/ui/dirty-state.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,qBAAa,UAAU;IAGV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,KAAK,CAAS;IAEtB,YAA6B,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAAI;IAElE,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAIxB;CACD"}