ooxml-core 0.18.0 → 0.20.0

package/dist/diagram/index.cjs

@@ -151,7 +151,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/diagram/index.mjs

@@ -149,7 +149,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/attr-units.d.ts

@@ -0,0 +1,11 @@
+import { type SignedTwips, type Twips } from '../units/units.js';
+import type { Paragraph } from './model-paragraph.js';
+/** A non-negative twip attribute as `Twips`, or undefined when absent or not a valid length. */
+export declare function twipsAttr(value: unknown): Twips | undefined;
+/** A possibly negative twip attribute as `SignedTwips`, or undefined when absent or not finite. */
+export declare function signedTwipsAttr(value: unknown): SignedTwips | undefined;
+type ParagraphTwips = Pick<Paragraph, 'spacingBeforeTwips' | 'spacingAfterTwips' | 'lineSpacingTwips' | 'indentLeftTwips' | 'indentRightTwips' | 'indentStartTwips' | 'indentEndTwips' | 'firstLineTwips' | 'hangingTwips'>;
+/** The paragraph's direct spacing and indent attributes as model fields; absent ones are omitted. */
+export declare function paragraphTwipsFromAttrs(attrs: Record<string, unknown>): ParagraphTwips;
+export {};
+//# sourceMappingURL=attr-units.d.ts.map

package/dist/docx/attr-units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attr-units.d.ts","sourceRoot":"","sources":["../../src/docx/attr-units.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAKtD,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,CAI3D;AACD,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAEvE;AAED,KAAK,cAAc,GAAG,IAAI,CACzB,SAAS,EACP,oBAAoB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,CAChB,CAAC;AACF,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAqBtF"}

package/dist/docx/block-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-parser.d.ts","sourceRoot":"","sources":["../../src/docx/block-parser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAY,KAAK,EAAsB,MAAM,YAAY,CAAC;AACxF,OAAO,EAON,KAAK,UAAU,EAEf,MAAM,UAAU,CAAC;AAKlB,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAsIjE,iBAAS,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CA0G/D;AAED,iBAAS,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,UAAU,EACrB,QAAQ,SAAK,EACb,OAAO,CAAC,EAAE,cAAc,GACtB,KAAK,EAAE,CAcT;AAYD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"block-parser.d.ts","sourceRoot":"","sources":["../../src/docx/block-parser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAY,KAAK,EAAW,MAAM,YAAY,CAAC;AAC7E,OAAO,EAMN,KAAK,UAAU,EACf,MAAM,UAAU,CAAC;AAIlB,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAsIjE,iBAAS,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CA0G/D;AAED,iBAAS,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,UAAU,EACrB,QAAQ,SAAK,EACb,OAAO,CAAC,EAAE,cAAc,GACtB,KAAK,EAAE,CAcT;AAYD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC"}

package/dist/docx/case-transform.d.ts

@@ -0,0 +1,9 @@
+export type CaseMode = 'sentence' | 'lower' | 'upper' | 'title' | 'toggle';
+/** Characters that make up a word, shared with the editor's caret-word lookup. */
+export declare const WORD: RegExp;
+/**
+ * Applies a Word "Change Case" mode to `text`. `atSentenceStart` says whether the text begins a
+ * sentence; it matters only for sentence case, which capitalises the first letter after `. ! ?`.
+ */
+export declare function transformCase(text: string, mode: CaseMode, atSentenceStart?: boolean): string;
+//# sourceMappingURL=case-transform.d.ts.map

package/dist/docx/case-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case-transform.d.ts","sourceRoot":"","sources":["../../src/docx/case-transform.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3E,kFAAkF;AAClF,eAAO,MAAM,IAAI,QAAoB,CAAC;AAOtC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,UAAO,GAAG,MAAM,CAsB1F"}

package/dist/docx/column-settings.d.ts

@@ -0,0 +1,16 @@
+import type { SectionColumns, SectionProperties } from './section-model.js';
+export declare const columnTextWidth: (section: SectionProperties) => number;
+/** Word's Left/Right presets reserve one third of the text width for the narrow column. */
+export declare function unequalColumnPreset(section: SectionProperties, preset: 'left' | 'right'): SectionColumns;
+export declare function columnPreset(columns: SectionColumns): string;
+export interface ColumnDraft {
+    widths: number[];
+    gaps: number[];
+}
+export declare function equalColumnDraft(total: number, count: number, gap: number): ColumnDraft;
+export declare function readColumnDraft(section: SectionProperties): ColumnDraft;
+/** Keep the overall text width fixed by taking the difference from the adjacent column. */
+export declare function changeColumnWidth(draft: ColumnDraft, index: number, width: number): void;
+export declare function changeColumnGap(draft: ColumnDraft, index: number, gap: number): void;
+export declare function validColumnDraft(draft: ColumnDraft, total: number): boolean;
+//# sourceMappingURL=column-settings.d.ts.map

package/dist/docx/column-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-settings.d.ts","sourceRoot":"","sources":["../../src/docx/column-settings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,eAAO,MAAM,eAAe,YAAa,iBAAiB,KAAG,MAIlC,CAAC;AAE5B,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,GAAG,OAAO,GACtB,cAAc,CAchB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAQ5D;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AACD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAQvF;AACD,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAgBvE;AACD,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKxF;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAIpF;AACD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAM3E"}

package/dist/docx/embedded.cjs

@@ -37,7 +37,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/embedded.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)

package/dist/docx/index.cjs

@@ -37,7 +37,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)
@@ -515,7 +516,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);
@@ -3673,7 +3674,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) => {
@@ -9663,6 +9664,427 @@ function plainText2(model) {
   ).join("\n");
 }
 
+// src/docx/column-settings.ts
+var columnTextWidth = (section) => section.pageWidthTwips - section.marginLeftTwips - section.marginRightTwips - (section.gutterTwips ?? 0);
+function unequalColumnPreset(section, preset) {
+  const gap = 720;
+  const available = columnTextWidth(section) - gap;
+  const narrow = Math.round(available / 3);
+  const wide = available - narrow;
+  return {
+    count: 2,
+    equalWidth: false,
+    spacingTwips: twips(gap),
+    widths: [
+      { widthTwips: twips(preset === "left" ? narrow : wide), spacingTwips: twips(gap) },
+      { widthTwips: twips(preset === "left" ? wide : narrow) }
+    ]
+  };
+}
+function columnPreset(columns) {
+  if (columns.equalWidth) return String(columns.count);
+  const [a, b] = columns.widths ?? [];
+  if (columns.count === 2 && a && b) {
+    if (Math.abs(a.widthTwips * 2 - b.widthTwips) <= 2) return "left";
+    if (Math.abs(b.widthTwips * 2 - a.widthTwips) <= 2) return "right";
+  }
+  return "";
+}
+function equalColumnDraft(total, count, gap) {
+  const width = Math.floor((total - gap * (count - 1)) / count);
+  return {
+    widths: Array.from(
+      { length: count },
+      (_, i) => i === count - 1 ? total - gap * (count - 1) - width * (count - 1) : width
+    ),
+    gaps: Array.from({ length: count }, (_, i) => i === count - 1 ? 0 : gap)
+  };
+}
+function readColumnDraft(section) {
+  const fallback = equalColumnDraft(
+    columnTextWidth(section),
+    section.columns.count,
+    section.columns.spacingTwips ?? 720
+  );
+  return !section.columns.equalWidth && section.columns.widths?.length === section.columns.count ? {
+    widths: section.columns.widths.map((column) => column.widthTwips),
+    gaps: section.columns.widths.map(
+      (column, i) => i === section.columns.count - 1 ? 0 : column.spacingTwips ?? section.columns.spacingTwips ?? 720
+    )
+  } : fallback;
+}
+function changeColumnWidth(draft, index, width) {
+  const delta = width - draft.widths[index];
+  draft.widths[index] = width;
+  const neighbor = index < draft.widths.length - 1 ? index + 1 : index - 1;
+  if (neighbor >= 0) draft.widths[neighbor] = draft.widths[neighbor] - delta;
+}
+function changeColumnGap(draft, index, gap) {
+  const delta = gap - draft.gaps[index];
+  draft.gaps[index] = gap;
+  if (index + 1 < draft.widths.length) draft.widths[index + 1] = draft.widths[index + 1] - delta;
+}
+function validColumnDraft(draft, total) {
+  return draft.widths.every((width) => Number.isSafeInteger(width) && width >= 720) && draft.gaps.every((gap) => Number.isSafeInteger(gap) && gap >= 0) && Math.abs(draft.widths.reduce((sum, value, i) => sum + value + draft.gaps[i], 0) - total) <= 1;
+}
+
+// src/docx/line-spacing.ts
+var lineSpacingOptions = [
+  ["inherit", "Line: style default"],
+  ["auto:240", "1.0 lines"],
+  ["auto:276", "1.15 lines"],
+  ["auto:360", "1.5 lines"],
+  ["auto:480", "2.0 lines"],
+  ["auto:600", "2.5 lines"],
+  ["auto:720", "3.0 lines"]
+];
+function lineSpacingValue(attrs) {
+  const rule = attrs.lineSpacingRule === "exact" || attrs.lineSpacingRule === "atLeast" ? attrs.lineSpacingRule : "auto";
+  if (!Number.isSafeInteger(attrs.lineSpacingTwips))
+    return attrs.lineSpacingRule === "exact" || attrs.lineSpacingRule === "atLeast" ? `rule-only:${attrs.lineSpacingRule}` : "inherit";
+  return `${rule}:${Number(attrs.lineSpacingTwips)}`;
+}
+function lineSpacingLabel(value) {
+  if (value === "inherit") return "Style default";
+  const ruleOnly = /^rule-only:(exact|atLeast)$/.exec(value);
+  if (ruleOnly) return `${ruleOnly[1] === "exact" ? "Exact" : "At least"} rule (no amount)`;
+  const match = /^(auto|exact|atLeast):(\d+)$/.exec(value);
+  if (!match) return "Mixed paragraphs";
+  const [, rule, rawTwips] = match;
+  const twips3 = Number(rawTwips);
+  if (rule === "auto") {
+    const ratios = {
+      240: "1.0",
+      276: "1.15",
+      360: "1.5",
+      480: "2.0",
+      600: "2.5",
+      720: "3.0"
+    };
+    return ratios[twips3] ? `${ratios[twips3]} lines` : `Automatic ${(twips3 / 240).toLocaleString(void 0, { maximumFractionDigits: 3 })} lines (${twips3}/240)`;
+  }
+  const points = (twips3 / 20).toLocaleString(void 0, { maximumFractionDigits: 2 });
+  return `${rule === "exact" ? "Exact" : "At least"} ${points} pt`;
+}
+function parseLineSpacingValue(value) {
+  const match = /^(auto|exact|atLeast):(\d+)$/.exec(value);
+  if (!match) return null;
+  const twips3 = Number(match[2]);
+  return Number.isSafeInteger(twips3) && twips3 >= 0 ? { rule: match[1], twips: twips3 } : null;
+}
+
+// src/docx/section-layout.ts
+function sectionLayoutJson(sections) {
+  return JSON.stringify(
+    sections.map(({ headers: _headers, footers: _footers, ...layout2 }) => layout2)
+  );
+}
+function sectionsFromLayout(json, prior, blocks) {
+  const layout2 = JSON.parse(json);
+  const order = new Map(blocks.map((block, index) => [block.id, index]));
+  const priorSections = prior ?? [];
+  const endOf = (section, index, list) => index === list.length - 1 ? Number.POSITIVE_INFINITY : order.get(section.endsAtBlockId) ?? -1;
+  const kept = layout2.filter(
+    (section, index) => index === layout2.length - 1 || order.has(section.endsAtBlockId)
+  );
+  return kept.map((section, index) => {
+    const end = endOf(section, index, kept);
+    const source = priorSections.find((candidate) => candidate.endsAtBlockId === section.endsAtBlockId) ?? priorSections.find(
+      (candidate, position) => endOf(candidate, position, priorSections) >= end
+    ) ?? priorSections.at(-1);
+    return {
+      ...section,
+      ...source?.headers ? { headers: source.headers } : {},
+      ...source?.footers ? { footers: source.footers } : {}
+    };
+  });
+}
+function sectionsOf(model) {
+  if (model.sections?.length) return model.sections;
+  const { page } = model;
+  return [
+    {
+      endsAtBlockId: model.blocks.at(-1)?.id ?? "",
+      type: "nextPage",
+      pageWidthTwips: twipsFromPixels(page.width),
+      pageHeightTwips: twipsFromPixels(page.height),
+      orientation: page.width > page.height ? "landscape" : "portrait",
+      marginTopTwips: signedTwipsFromPixels(page.marginTop),
+      marginRightTwips: twipsFromPixels(page.marginRight),
+      marginBottomTwips: signedTwipsFromPixels(page.marginBottom),
+      marginLeftTwips: twipsFromPixels(page.marginLeft),
+      headerDistanceTwips: twips(720),
+      footerDistanceTwips: twips(720),
+      gutterTwips: twips(0),
+      columns: { count: 1, spacingTwips: twips(720), equalWidth: true }
+    }
+  ];
+}
+
+// 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))
+  });
+}
+
 exports.DEFAULT_STYLES_XML = DEFAULT_STYLES_XML;
 exports.DEFAULT_TABLE_BORDERS = DEFAULT_TABLE_BORDERS;
 exports.DEFAULT_TOC_INSTRUCTION = DEFAULT_TOC_INSTRUCTION;
@@ -9674,6 +10096,8 @@ exports.EMU_PER_INCH = EMU_PER_INCH;
 exports.EMU_PER_PIXEL = EMU_PER_PIXEL;
 exports.EMU_PER_POINT = EMU_PER_POINT;
 exports.LIGATURE_VALUES = LIGATURE_VALUES;
+exports.PAGE_SIZES = PAGE_SIZES;
+exports.PAGE_SIZE_OPTIONS = PAGE_SIZE_OPTIONS;
 exports.PIXELS_PER_INCH = PIXELS_PER_INCH;
 exports.PROPERTY_FIELDS = PROPERTY_FIELDS;
 exports.ST_AlgClass = ST_AlgClass;
@@ -9777,16 +10201,22 @@ exports.ST_YAlign = ST_YAlign;
 exports.ST_Zoom = ST_Zoom;
 exports.TWIPS_PER_INCH = TWIPS_PER_INCH;
 exports.TWIPS_PER_POINT = TWIPS_PER_POINT;
+exports.WORD = WORD;
 exports.WORD_HIGHLIGHT_TOKENS = WORD_HIGHLIGHT_TOKENS;
 exports.WORD_UNDERLINE_TOKENS = WORD_UNDERLINE_TOKENS;
 exports.acceptAllRevisions = acceptAllRevisions;
 exports.acceptRevision = acceptRevision;
 exports.alignFromJustification = alignFromJustification;
+exports.applyPageSetup = applyPageSetup;
 exports.applyThemeShade = applyThemeShade;
 exports.applyThemeTint = applyThemeTint;
 exports.assertValidDocumentModel = assertValidDocumentModel;
 exports.buildTableOfContents = buildTableOfContents;
 exports.captionParagraphs = captionParagraphs;
+exports.changeColumnGap = changeColumnGap;
+exports.changeColumnWidth = changeColumnWidth;
+exports.columnPreset = columnPreset;
+exports.columnTextWidth = columnTextWidth;
 exports.computeListLabels = computeListLabels;
 exports.createDocument = createDocument;
 exports.createListDefinition = createListDefinition;
@@ -9805,6 +10235,7 @@ exports.emuFromPixels = emuFromPixels;
 exports.emuToPixels = emuToPixels;
 exports.ensureListDefinition = ensureListDefinition;
 exports.enumValue = enumValue;
+exports.equalColumnDraft = equalColumnDraft;
 exports.fieldName = fieldName;
 exports.findRevision = findRevision;
 exports.findTableOfContents = findTableOfContents;
@@ -9922,18 +10353,24 @@ exports.isThemeColorToken = isThemeColorToken;
 exports.isValidLanguageTag = isValidLanguageTag;
 exports.isWordHighlightToken = isWordHighlightToken;
 exports.isWordUnderlineStyle = isWordUnderlineStyle;
+exports.lineSpacingLabel = lineSpacingLabel;
+exports.lineSpacingOptions = lineSpacingOptions;
+exports.lineSpacingValue = lineSpacingValue;
 exports.linkStylesToList = linkStylesToList;
 exports.listRevisions = listRevisions;
 exports.loadDocx = loadDocx;
 exports.numberNotesInOrder = numberNotesInOrder;
 exports.onOffAttribute = onOffAttribute;
 exports.onOffElement = onOffElement;
+exports.pageSizeOf = pageSizeOf;
+exports.paragraphTwipsFromAttrs = paragraphTwipsFromAttrs;
 exports.parseColorSchemeMapping = parseColorSchemeMapping;
 exports.parseEighthPoints = parseEighthPoints;
 exports.parseHalfPoints = parseHalfPoints;
 exports.parseHexColor = parseHexColor;
 exports.parseInteger = parseInteger;
 exports.parseJustification = parseJustification;
+exports.parseLineSpacingValue = parseLineSpacingValue;
 exports.parseNumberingCatalog = parseNumberingCatalog;
 exports.parseOnOff = parseOnOff;
 exports.parseParagraphStyleCatalog = parseParagraphStyleCatalog;
@@ -9948,6 +10385,9 @@ exports.parseTintShade = parseTintShade;
 exports.parseTwips = parseTwips;
 exports.parseUnsignedInteger = parseUnsignedInteger;
 exports.plainText = plainText2;
+exports.presetOf = presetOf;
+exports.readColumnDraft = readColumnDraft;
+exports.readPageSetup = readPageSetup;
 exports.rejectAllRevisions = rejectAllRevisions;
 exports.rejectRevision = rejectRevision;
 exports.reportParseWarning = reportParseWarning;
@@ -9967,7 +10407,19 @@ exports.roundHalfPoints = roundHalfPoints;
 exports.roundSignedTwips = roundSignedTwips;
 exports.roundTwips = roundTwips;
 exports.saveDocx = saveDocx;
+exports.sectionLayoutJson = sectionLayoutJson;
+exports.sectionsFromLayout = sectionsFromLayout;
+exports.sectionsOf = sectionsOf;
+exports.setColumns = setColumns;
+exports.setLineNumbering = setLineNumbering;
+exports.setMargins = setMargins;
+exports.setOrientation = setOrientation;
+exports.setPageNumbering = setPageNumbering;
+exports.setPageSize = setPageSize;
+exports.setTitlePage = setTitlePage;
+exports.setVerticalAlign = setVerticalAlign;
 exports.signedTwips = signedTwips;
+exports.signedTwipsAttr = signedTwipsAttr;
 exports.signedTwipsFromPixels = signedTwipsFromPixels;
 exports.signedTwipsFromPoints = signedTwipsFromPoints;
 exports.tableOfFiguresInstruction = tableOfFiguresInstruction;
@@ -9976,15 +10428,21 @@ exports.tocCaptionLabel = tocCaptionLabel;
 exports.tocEntries = tocEntries;
 exports.tocHyperlinks = tocHyperlinks;
 exports.tocLevels = tocLevels;
+exports.transformCase = transformCase;
 exports.twips = twips;
+exports.twipsAttr = twipsAttr;
 exports.twipsFromInches = twipsFromInches;
 exports.twipsFromPixels = twipsFromPixels;
 exports.twipsFromPoints = twipsFromPoints;
 exports.twipsToInches = twipsToInches;
 exports.twipsToPixels = twipsToPixels;
 exports.twipsToPoints = twipsToPoints;
+exports.unequalColumnPreset = unequalColumnPreset;
 exports.universalMeasureToTwips = universalMeasureToTwips;
 exports.updateTableOfContents = updateTableOfContents;
+exports.validColumnDraft = validColumnDraft;
 exports.validateDocumentModel = validateDocumentModel;
+exports.validatePageSetup = validatePageSetup;
 exports.withParseWarnings = withParseWarnings;
+exports.withSection = withSection;
 exports.withTocBookmarks = withTocBookmarks;