@beyondwork/docx-react-component 1.0.102 → 1.0.103

package/src/io/ooxml/parse-main-document.ts

@@ -26,6 +26,7 @@ import type {
   SectionPageBorders,
   DrawingFrameNode,
   UnknownPropertyChild,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import type { OpcRelationship } from "./part-manifest.ts";
 import { SCOPE_MARKER_BOOKMARK_PREFIX } from "./parse-scope-markers.ts";
@@ -2288,7 +2289,7 @@ function readParagraphSpacing(node: XmlElementNode): ParagraphSpacing | undefine
   );
   if (!spacingNode) return undefined;
 
-  const spacing: ParagraphSpacing = {};
+  const spacing: Mutable<ParagraphSpacing> = {};
   const before = spacingNode.attributes["w:before"] ?? spacingNode.attributes.before;
   const after = spacingNode.attributes["w:after"] ?? spacingNode.attributes.after;
   const line = spacingNode.attributes["w:line"] ?? spacingNode.attributes.line;
@@ -2332,7 +2333,7 @@ function readParagraphIndentation(node: XmlElementNode): ParagraphIndentation |
   );
   if (!indNode) return undefined;
 
-  const indentation: ParagraphIndentation = {};
+  const indentation: Mutable<ParagraphIndentation> = {};
   const left = indNode.attributes["w:left"] ?? indNode.attributes.left;
   const right = indNode.attributes["w:right"] ?? indNode.attributes.right;
   const firstLine = indNode.attributes["w:firstLine"] ?? indNode.attributes.firstLine;
@@ -2450,7 +2451,7 @@ function readParagraphBorders(node: XmlElementNode): ParagraphBorders | undefine
     return undefined;
   }
 
-  const borders: ParagraphBorders = {};
+  const borders: Mutable<ParagraphBorders> = {};
   for (const [name, key] of [
     ["top", "top"],
     ["left", "left"],
@@ -2481,7 +2482,7 @@ function readParagraphShading(node: XmlElementNode): ParagraphShading | undefine
     return undefined;
   }
 
-  const shading: ParagraphShading = {};
+  const shading: Mutable<ParagraphShading> = {};
   const fill = shadingNode.attributes["w:fill"] ?? shadingNode.attributes.fill;
   const color = shadingNode.attributes["w:color"] ?? shadingNode.attributes.color;
   const val = shadingNode.attributes["w:val"] ?? shadingNode.attributes.val;
@@ -2491,14 +2492,14 @@ function readParagraphShading(node: XmlElementNode): ParagraphShading | undefine
   const themeColor = shadingNode.attributes["w:themeColor"] ?? shadingNode.attributes.themeColor;
   const themeColorTint = shadingNode.attributes["w:themeColorTint"] ?? shadingNode.attributes.themeColorTint;
   const themeColorShade = shadingNode.attributes["w:themeColorShade"] ?? shadingNode.attributes.themeColorShade;
-  if (fill) shading.fill = fill;
-  if (color) shading.color = color;
-  if (val) shading.val = val;
-  if (themeFill) shading.themeFill = themeFill;
-  if (themeFillTint) shading.themeFillTint = themeFillTint;
-  if (themeFillShade) shading.themeFillShade = themeFillShade;
-  if (themeColor) shading.themeColor = themeColor;
-  if (themeColorTint) shading.themeColorTint = themeColorTint;
+  if (fill) (shading as Mutable<typeof shading>).fill = fill;
+  if (color) (shading as Mutable<typeof shading>).color = color;
+  if (val) (shading as Mutable<typeof shading>).val = val;
+  if (themeFill) (shading as Mutable<typeof shading>).themeFill = themeFill;
+  if (themeFillTint) (shading as Mutable<typeof shading>).themeFillTint = themeFillTint;
+  if (themeFillShade) (shading as Mutable<typeof shading>).themeFillShade = themeFillShade;
+  if (themeColor) (shading as Mutable<typeof shading>).themeColor = themeColor;
+  if (themeColorTint) (shading as Mutable<typeof shading>).themeColorTint = themeColorTint;
   if (themeColorShade) shading.themeColorShade = themeColorShade;
   return Object.keys(shading).length > 0 ? shading : undefined;
 }
@@ -2511,7 +2512,7 @@ function readParagraphCnfStyle(node: XmlElementNode): string | undefined {
 }
 
 function readBorder(node: XmlElementNode): ParagraphBorders[keyof ParagraphBorders] {
-  const border: NonNullable<ParagraphBorders[keyof ParagraphBorders]> = {};
+  const border: Mutable<NonNullable<ParagraphBorders[keyof ParagraphBorders]>> = {};
   const value = node.attributes["w:val"] ?? node.attributes.val;
   const size = node.attributes["w:sz"] ?? node.attributes.sz;
   const space = node.attributes["w:space"] ?? node.attributes.space;
@@ -3632,7 +3633,7 @@ function readSectionPropertiesXmlFromPPr(
 export function parseSectionPropertiesFromElement(
   node: XmlElementNode,
 ): SectionProperties {
-  const props: SectionProperties = {};
+  const props: Mutable<SectionProperties> = {};
 
   for (const child of node.children) {
     if (child.type !== "element") continue;
@@ -3643,7 +3644,7 @@ export function parseSectionPropertiesFromElement(
         const w = safeParseInt(child.attributes["w:w"]);
         const h = safeParseInt(child.attributes["w:h"]);
         if (w !== undefined && h !== undefined) {
-          const pageSize: PageSize = { width: w, height: h };
+          const pageSize: Mutable<PageSize> = { width: w, height: h };
           const orient = child.attributes["w:orient"];
           if (orient === "landscape" || orient === "portrait") {
             pageSize.orientation = orient;
@@ -3658,26 +3659,26 @@ export function parseSectionPropertiesFromElement(
         const bottom = safeParseInt(child.attributes["w:bottom"]);
         const left = safeParseInt(child.attributes["w:left"]);
         if (top !== undefined && right !== undefined && bottom !== undefined && left !== undefined) {
-          const margins: PageMargins = { top, right, bottom, left };
+          const margins: Mutable<PageMargins> = { top, right, bottom, left };
           const header = safeParseInt(child.attributes["w:header"]);
           const footer = safeParseInt(child.attributes["w:footer"]);
           const gutter = safeParseInt(child.attributes["w:gutter"]);
-          if (header !== undefined) margins.header = header;
-          if (footer !== undefined) margins.footer = footer;
-          if (gutter !== undefined) margins.gutter = gutter;
+          if (header !== undefined) (margins as Mutable<typeof margins>).header = header;
+          if (footer !== undefined) (margins as Mutable<typeof margins>).footer = footer;
+          if (gutter !== undefined) (margins as Mutable<typeof margins>).gutter = gutter;
           props.pageMargins = margins;
         }
         break;
       }
       case "cols": {
-        const columns: ColumnProperties = {};
+        const columns: Mutable<ColumnProperties> = {};
         const num = safeParseInt(child.attributes["w:num"]);
         const space = safeParseInt(child.attributes["w:space"]);
         const equalWidth = child.attributes["w:equalWidth"];
         const sep = child.attributes["w:sep"];
-        if (num !== undefined) columns.count = num;
-        if (space !== undefined) columns.space = space;
-        if (equalWidth !== undefined) columns.equalWidth = equalWidth !== "0" && equalWidth !== "false";
+        if (num !== undefined) (columns as Mutable<typeof columns>).count = num;
+        if (space !== undefined) (columns as Mutable<typeof columns>).space = space;
+        if (equalWidth !== undefined) (columns as Mutable<typeof columns>).equalWidth = equalWidth !== "0" && equalWidth !== "false";
         if (sep === "1" || sep === "true") columns.separator = true;
         const colDefs: Array<{ width: number; space?: number }> = [];
         for (const colChild of child.children) {
@@ -3689,31 +3690,31 @@ export function parseSectionPropertiesFromElement(
             }
           }
         }
-        if (colDefs.length > 0) columns.columns = colDefs;
+        if (colDefs.length > 0) (columns as Mutable<typeof columns>).columns = colDefs;
         if (Object.keys(columns).length > 0) props.columns = columns;
         break;
       }
       case "pgNumType": {
-        const numbering: PageNumbering = {};
+        const numbering: Mutable<PageNumbering> = {};
         const fmt = child.attributes["w:fmt"];
         const start = safeParseInt(child.attributes["w:start"]);
         const chapStyle = child.attributes["w:chapStyle"];
         const chapSep = child.attributes["w:chapSep"];
-        if (fmt) numbering.format = fmt;
-        if (start !== undefined) numbering.start = start;
-        if (chapStyle) numbering.chapStyle = chapStyle;
-        if (chapSep) numbering.chapSep = chapSep;
+        if (fmt) (numbering as Mutable<typeof numbering>).format = fmt;
+        if (start !== undefined) (numbering as Mutable<typeof numbering>).start = start;
+        if (chapStyle) (numbering as Mutable<typeof numbering>).chapStyle = chapStyle;
+        if (chapSep) (numbering as Mutable<typeof numbering>).chapSep = chapSep;
         if (Object.keys(numbering).length > 0) props.pageNumbering = numbering;
         break;
       }
       case "lnNumType": {
-        const lineNumbering: SectionLineNumbering = {};
+        const lineNumbering: Mutable<SectionLineNumbering> = {};
         const countBy = safeParseInt(child.attributes["w:countBy"]);
         const start = safeParseInt(child.attributes["w:start"]);
         const distance = safeParseInt(child.attributes["w:distance"]);
         const restart = child.attributes["w:restart"];
-        if (countBy !== undefined) lineNumbering.countBy = countBy;
-        if (start !== undefined) lineNumbering.start = start;
+        if (countBy !== undefined) (lineNumbering as Mutable<typeof lineNumbering>).countBy = countBy;
+        if (start !== undefined) (lineNumbering as Mutable<typeof lineNumbering>).start = start;
         if (distance !== undefined) lineNumbering.distance = distance;
         if (
           restart === "newPage" ||
@@ -3728,7 +3729,7 @@ export function parseSectionPropertiesFromElement(
         break;
       }
       case "pgBorders": {
-        const pageBorders: SectionPageBorders = {};
+        const pageBorders: Mutable<SectionPageBorders> = {};
         const offsetFrom = child.attributes["w:offsetFrom"];
         const display = child.attributes["w:display"];
         const zOrder = child.attributes["w:zOrder"];
@@ -3765,7 +3766,7 @@ export function parseSectionPropertiesFromElement(
         break;
       }
       case "docGrid": {
-        const documentGrid: SectionDocumentGrid = {};
+        const documentGrid: Mutable<SectionDocumentGrid> = {};
         const type = child.attributes["w:type"];
         const linePitch = safeParseInt(child.attributes["w:linePitch"]);
         const charSpace = safeParseInt(child.attributes["w:charSpace"]);
@@ -3777,7 +3778,7 @@ export function parseSectionPropertiesFromElement(
         ) {
           documentGrid.type = type;
         }
-        if (linePitch !== undefined) documentGrid.linePitch = linePitch;
+        if (linePitch !== undefined) (documentGrid as Mutable<typeof documentGrid>).linePitch = linePitch;
         if (charSpace !== undefined) documentGrid.charSpace = charSpace;
         if (Object.keys(documentGrid).length > 0) {
           props.documentGrid = documentGrid;
@@ -3856,7 +3857,7 @@ function safeParseInt(value: string | undefined): number | undefined {
 function readFootnoteLikeProperties(
   node: XmlElementNode,
 ): FootnoteProperties | undefined {
-  const result: FootnoteProperties = {};
+  const result: Mutable<FootnoteProperties> = {};
 
   for (const child of node.children) {
     if (child.type !== "element") continue;
@@ -3902,15 +3903,15 @@ function readFootnoteLikeProperties(
 }
 
 function parseBorderSpec(node: XmlElementNode): BorderSpec | undefined {
-  const border: BorderSpec = {};
+  const border: Mutable<BorderSpec> = {};
   const value = node.attributes["w:val"];
   const size = safeParseInt(node.attributes["w:sz"]);
   const space = safeParseInt(node.attributes["w:space"]);
   const color = node.attributes["w:color"];
 
-  if (value) border.value = value;
-  if (size !== undefined) border.size = size;
-  if (space !== undefined) border.space = space;
+  if (value) (border as Mutable<typeof border>).value = value;
+  if (size !== undefined) (border as Mutable<typeof border>).size = size;
+  if (space !== undefined) (border as Mutable<typeof border>).space = space;
   if (color) border.color = color;
 
   return Object.keys(border).length > 0 ? border : undefined;

package/src/io/ooxml/parse-numbering.ts

@@ -8,6 +8,7 @@ import type {
   ParagraphSpacing,
   ParagraphIndentation,
   TabStop,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import { readRunProperties } from "./parse-run-formatting.ts";
 import type { OpcRelationship } from "./part-manifest.ts";
@@ -519,7 +520,7 @@ function readParagraphIndentation(node: XmlElementNode): ParagraphIndentation |
     return undefined;
   }
 
-  const indentation: ParagraphIndentation = {};
+  const indentation: Mutable<ParagraphIndentation> = {};
   const left = readStringAttr(indNode, "w:start") ?? readStringAttr(indNode, "w:left");
   const right = readStringAttr(indNode, "w:end") ?? readStringAttr(indNode, "w:right");
   const firstLine = readStringAttr(indNode, "w:firstLine");
@@ -560,7 +561,7 @@ function readParagraphSpacing(node: XmlElementNode): ParagraphSpacing | undefine
     return undefined;
   }
 
-  const spacing: ParagraphSpacing = {};
+  const spacing: Mutable<ParagraphSpacing> = {};
   const before = readStringAttr(spacingNode, "w:before");
   const after = readStringAttr(spacingNode, "w:after");
   const line = readStringAttr(spacingNode, "w:line");

package/src/io/ooxml/parse-object.ts

@@ -18,7 +18,7 @@
  *   responsibility post-v2.0; this module emits only data.
  */
 
-import type { OleEmbedNode } from "../../model/canonical-document.ts";
+import type { OleEmbedNode, Mutable } from "../../model/canonical-document.ts";
 import type { OpcRelationship } from "./part-manifest.ts";
 import type { XmlElementNode } from "./xml-element.ts";
 import { resolveOleRelationship } from "./parse-ole-relationship.ts";
@@ -93,13 +93,13 @@ export function parseObject(
 
   const metadata: OleEmbedNode["metadata"] = {};
   if (resolved.originalFilename) {
-    metadata.originalFilename = resolved.originalFilename;
+    (metadata as Mutable<typeof metadata>).originalFilename = resolved.originalFilename;
   }
   if (classId) {
-    metadata.classId = classId;
+    (metadata as Mutable<typeof metadata>).classId = classId;
   }
   if (shapeId) {
-    metadata.shapeId = shapeId;
+    (metadata as Mutable<typeof metadata>).shapeId = shapeId;
   }
 
   const id =
@@ -107,7 +107,7 @@ export function parseObject(
       ? `ole-embed-${resolved.relationshipId}-${occurrenceIndex}`
       : `ole-embed-${resolved.relationshipId}`;
 
-  const result: OleEmbedNode = {
+  const result: Mutable<OleEmbedNode> = {
     type: "ole_embed",
     id,
     embedType: "oleObject",
@@ -116,7 +116,7 @@ export function parseObject(
     rawXml,
   };
   if (progId) {
-    result.progId = progId;
+    (result as Mutable<typeof result>).progId = progId;
   }
   return result;
 }

package/src/io/ooxml/parse-paragraph-formatting.ts

@@ -14,6 +14,7 @@ import type {
   ParagraphShading,
   ParagraphSpacing,
   TabStop,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import { readRunProperties } from "./parse-run-formatting.ts";
 import { findChildOptional, localName, readIntAttr, readIntVal, readOnOff } from "./xml-attr-helpers.ts";
@@ -87,31 +88,31 @@ const PPR_GRAB_BAG_DESCRIPTOR: PropertyGrabBagDescriptor = {
 };
 
 function readSpacing(node: XmlElementNode): ParagraphSpacing | undefined {
-  const out: ParagraphSpacing = {};
+  const out: Mutable<ParagraphSpacing> = {};
   const before = readIntAttr(node, "w:before");
   const after = readIntAttr(node, "w:after");
   const line = readIntAttr(node, "w:line");
   const rule = node.attributes["w:lineRule"] ?? node.attributes.lineRule;
-  if (before !== undefined) out.before = before;
-  if (after !== undefined) out.after = after;
+  if (before !== undefined) (out as Mutable<typeof out>).before = before;
+  if (after !== undefined) (out as Mutable<typeof out>).after = after;
   if (line !== undefined) out.line = line;
   if (rule) {
     const n = rule.toLowerCase();
-    if (n === "auto" || n === "exact") out.lineRule = n;
+    if (n === "auto" || n === "exact") (out as Mutable<typeof out>).lineRule = n;
     else if (n === "atleast") out.lineRule = "atLeast";
   }
   return Object.keys(out).length > 0 ? out : undefined;
 }
 
 function readIndent(node: XmlElementNode): ParagraphIndentation | undefined {
-  const out: ParagraphIndentation = {};
+  const out: Mutable<ParagraphIndentation> = {};
   const left = readIntAttr(node, "w:left") ?? readIntAttr(node, "w:start");
   const right = readIntAttr(node, "w:right") ?? readIntAttr(node, "w:end");
   const firstLine = readIntAttr(node, "w:firstLine");
   const hanging = readIntAttr(node, "w:hanging");
-  if (left !== undefined) out.left = left;
-  if (right !== undefined) out.right = right;
-  if (firstLine !== undefined) out.firstLine = firstLine;
+  if (left !== undefined) (out as Mutable<typeof out>).left = left;
+  if (right !== undefined) (out as Mutable<typeof out>).right = right;
+  if (firstLine !== undefined) (out as Mutable<typeof out>).firstLine = firstLine;
   if (hanging !== undefined) out.hanging = hanging;
   return Object.keys(out).length > 0 ? out : undefined;
 }
@@ -138,7 +139,7 @@ function readTabStops(node: XmlElementNode): TabStop[] | undefined {
 }
 
 function readBorders(node: XmlElementNode): ParagraphBorders | undefined {
-  const out: ParagraphBorders = {};
+  const out: Mutable<ParagraphBorders> = {};
   const sides = ["top", "bottom", "left", "right", "between", "bar"] as const;
   for (const side of sides) {
     const child = findChildOptional(node, side);
@@ -205,7 +206,7 @@ function readShading(node: XmlElementNode): ParagraphShading | undefined {
  * text frames, drop-caps); extension attrs are rare in that corpus.
  */
 export function readFrameProperties(node: XmlElementNode): FrameProperties | undefined {
-  const out: FrameProperties = {};
+  const out: Mutable<FrameProperties> = {};
   const width = readIntAttr(node, "w:w");
   if (width !== undefined) out.widthTwips = width;
   const height = readIntAttr(node, "w:h");
@@ -268,7 +269,7 @@ export function readParagraphProperties(
 ): CanonicalParagraphFormatting | undefined {
   if (!node) return undefined;
 
-  const out: CanonicalParagraphFormatting = {};
+  const out: Mutable<CanonicalParagraphFormatting> = {};
 
   const spacingNode = findChildOptional(node, "spacing");
   if (spacingNode) {

package/src/io/ooxml/parse-picture.ts

@@ -1,4 +1,4 @@
-import type { PictureContent } from "../../model/canonical-document.ts";
+import type { PictureContent, Mutable } from "../../model/canonical-document.ts";
 import {
   type XmlElementNode,
   findFirstChild,
@@ -100,21 +100,21 @@ export function parsePicture(graphicDataEl: XmlElementNode): PictureContent | nu
   const glowEl = effectLst ? findFirstChild(effectLst, "glow") : undefined;
   const glow = glowEl ? parseGlow(glowEl) : undefined;
 
-  const result: PictureContent = { type: "picture", blipRef };
-  if (isLinked) result.isLinked = true;
+  const result: Mutable<PictureContent> = { type: "picture", blipRef };
+  if (isLinked) (result as Mutable<typeof result>).isLinked = true;
   if (lum && (lum.bright !== undefined || lum.contrast !== undefined)) {
-    result.lum = lum;
+    (result as Mutable<typeof result>).lum = lum;
   }
-  if (srcRect) result.srcRect = srcRect;
-  if (stretch !== undefined) result.stretch = stretch;
+  if (srcRect) (result as Mutable<typeof result>).srcRect = srcRect;
+  if (stretch !== undefined) (result as Mutable<typeof result>).stretch = stretch;
   if (tile !== undefined) result.tile = tile;
-  if (rotation !== undefined) result.rotation = rotation;
-  if (flipH !== undefined) result.flipH = flipH;
-  if (flipV !== undefined) result.flipV = flipV;
-  if (presetGeom) result.presetGeom = presetGeom;
-  if (softEdgeRadius !== undefined) result.softEdgeRadius = softEdgeRadius;
-  if (outerShadow) result.outerShadow = outerShadow;
-  if (glow) result.glow = glow;
+  if (rotation !== undefined) (result as Mutable<typeof result>).rotation = rotation;
+  if (flipH !== undefined) (result as Mutable<typeof result>).flipH = flipH;
+  if (flipV !== undefined) (result as Mutable<typeof result>).flipV = flipV;
+  if (presetGeom) (result as Mutable<typeof result>).presetGeom = presetGeom;
+  if (softEdgeRadius !== undefined) (result as Mutable<typeof result>).softEdgeRadius = softEdgeRadius;
+  if (outerShadow) (result as Mutable<typeof result>).outerShadow = outerShadow;
+  if (glow) (result as Mutable<typeof result>).glow = glow;
   return result;
 }
 
@@ -172,13 +172,13 @@ function readTileAttrs(
     const v = tileEl.attributes[key];
     if (v !== undefined) {
       const n = parseInt(v, 10);
-      if (Number.isFinite(n)) result[key] = n;
+      if (Number.isFinite(n)) (result as Mutable<typeof result>)[key] = n;
     }
   }
   const flip = tileEl.attributes.flip;
-  if (flip === "x" || flip === "y" || flip === "xy") result.flip = flip;
+  if (flip === "x" || flip === "y" || flip === "xy") (result as Mutable<typeof result>).flip = flip;
   const algn = tileEl.attributes.algn;
-  if (algn) result.algn = algn;
+  if (algn) (result as Mutable<typeof result>).algn = algn;
   return Object.keys(result).length > 0 ? result : {};
 }
 

package/src/io/ooxml/parse-run-formatting.ts

@@ -1,6 +1,7 @@
 import type {
   CanonicalRunFormatting,
   ThemeFontSlot,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import { findChildOptional, readIntVal, readOnOff, readStringAttr } from "./xml-attr-helpers.ts";
 import type { XmlElementNode } from "./xml-element.ts";
@@ -58,7 +59,7 @@ export function readRunProperties(
 ): CanonicalRunFormatting | undefined {
   if (!node) return undefined;
 
-  const rPr: CanonicalRunFormatting = {};
+  const rPr: Mutable<CanonicalRunFormatting> = {};
 
   const bold = readOnOff(findChildOptional(node, "b"));
   if (bold !== undefined) rPr.bold = bold;
@@ -121,9 +122,9 @@ export function readRunProperties(
     const hAnsi = rFonts.attributes["w:hAnsi"] ?? rFonts.attributes.hAnsi;
     const eastAsia = rFonts.attributes["w:eastAsia"] ?? rFonts.attributes.eastAsia;
     const cs = rFonts.attributes["w:cs"] ?? rFonts.attributes.cs;
-    if (ascii) rPr.fontFamilyAscii = ascii;
-    if (hAnsi) rPr.fontFamilyHAnsi = hAnsi;
-    if (eastAsia) rPr.fontFamilyEastAsia = eastAsia;
+    if (ascii) (rPr as Mutable<typeof rPr>).fontFamilyAscii = ascii;
+    if (hAnsi) (rPr as Mutable<typeof rPr>).fontFamilyHAnsi = hAnsi;
+    if (eastAsia) (rPr as Mutable<typeof rPr>).fontFamilyEastAsia = eastAsia;
     if (cs) rPr.fontFamilyCs = cs;
     const primary = ascii ?? hAnsi ?? eastAsia ?? cs;
     if (primary) rPr.fontFamily = primary;
@@ -150,9 +151,9 @@ export function readRunProperties(
         rFonts.attributes["w:csTheme"] ??
         rFonts.attributes.csTheme,
     );
-    if (asciiTheme) rPr.asciiTheme = asciiTheme;
-    if (hAnsiTheme) rPr.hAnsiTheme = hAnsiTheme;
-    if (eastAsiaTheme) rPr.eastAsiaTheme = eastAsiaTheme;
+    if (asciiTheme) (rPr as Mutable<typeof rPr>).asciiTheme = asciiTheme;
+    if (hAnsiTheme) (rPr as Mutable<typeof rPr>).hAnsiTheme = hAnsiTheme;
+    if (eastAsiaTheme) (rPr as Mutable<typeof rPr>).eastAsiaTheme = eastAsiaTheme;
     if (csTheme) rPr.csTheme = csTheme;
   }
 
@@ -171,9 +172,9 @@ export function readRunProperties(
       color.attributes["w:themeTint"] ?? color.attributes["themeTint"];
     const shade =
       color.attributes["w:themeShade"] ?? color.attributes["themeShade"];
-    if (val) rPr.colorHex = val;
-    if (theme) rPr.colorThemeSlot = theme;
-    if (tint) rPr.colorThemeTint = tint;
+    if (val) (rPr as Mutable<typeof rPr>).colorHex = val;
+    if (theme) (rPr as Mutable<typeof rPr>).colorThemeSlot = theme;
+    if (tint) (rPr as Mutable<typeof rPr>).colorThemeTint = tint;
     if (shade) rPr.colorThemeShade = shade;
   }
 

package/src/io/ooxml/parse-settings.ts

@@ -5,6 +5,7 @@ import type {
   DocumentSettings,
   FootnoteProperties,
   ThemeColorSlot,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import { parseXml } from "./xml-parser.ts";
 import { localName } from "./xml-attr-helpers.ts";
@@ -160,7 +161,7 @@ function readFootnoteLikeProperties(
 ): FootnoteProperties | undefined {
   if (!element) return undefined;
 
-  const result: FootnoteProperties = {};
+  const result: Mutable<FootnoteProperties> = {};
   for (const child of element.children) {
     if (child.type !== "element") continue;
     const name = localName(child.name);

package/src/io/ooxml/parse-shapes.ts

@@ -14,6 +14,7 @@ import type {
   BlockNode,
   ShapeContent,
   TextBoxBodyProperties,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import { parseFill } from "./parse-fill.ts";
 import {
@@ -46,7 +47,7 @@ export interface ParsedWpsShape {
    * shape-textbox paragraphs). Same shape + semantics as
    * `ShapeContent.txbxBlocks` on the drawing-frame path.
    */
-  txbxBlocks?: ReadonlyArray<BlockNode>;
+  txbxBlocks?: BlockNode[];
   /** DrawML geometry preset, e.g. "rect", "roundRect". */
   geometry?: string;
   /** Original drawing XML for lossless round-trip export. */
@@ -129,7 +130,7 @@ export function parseShapeXml(
   // content (CCEP "Copyright CCEP STRICTLY CONFIDENTIAL" footer band)
   // is reachable only via the `.text` summary string — L03 cascade +
   // L11 render can't walk runs/marks.
-  let txbxBlocks: ReadonlyArray<BlockNode> | undefined;
+  let txbxBlocks: BlockNode[] | undefined;
   if (txbxContentXml && blockParser) {
     try {
       // The `blockParser` callback is supplied by parse-main-document.ts
@@ -142,7 +143,7 @@ export function parseShapeXml(
       // canonical; a structural `as unknown as BlockNode[]` preserves
       // type safety at every consumer site (L03 cascade, L11 render,
       // validator walk).
-      txbxBlocks = blockParser(txbxContentXml) as unknown as ReadonlyArray<BlockNode>;
+      txbxBlocks = blockParser(txbxContentXml) as unknown as BlockNode[];
     } catch {
       txbxBlocks = undefined;
     }
@@ -271,7 +272,7 @@ export function parseShapeContent(
   const txbxContentXml = txbxContent ? extractRawXml(txbxContent) : undefined;
   const text = txbxContent ? extractAllText(txbxContent).trim() || undefined : undefined;
 
-  let txbxBlocks: ReadonlyArray<BlockNode> | undefined;
+  let txbxBlocks: BlockNode[] | undefined;
   if (txbxContentXml && blockParser) {
     try {
       // See `TxbxBlockParser` doc above: runtime output is canonical
@@ -279,7 +280,7 @@ export function parseShapeContent(
       // footer fixture 2026-04-24). Cast at the assembly seam so
       // downstream consumers (L03, L11, validator) get canonical types
       // without local `as unknown` ceremony.
-      txbxBlocks = blockParser(txbxContentXml) as unknown as ReadonlyArray<BlockNode>;
+      txbxBlocks = blockParser(txbxContentXml) as unknown as BlockNode[];
     } catch {
       // Preserve-only fallback: keep txbxContentXml for serialization; leave
       // txbxBlocks undefined so consumers know recursion did not succeed.
@@ -294,15 +295,15 @@ export function parseShapeContent(
   // roundRect text boxes + callout/ellipse shapes as non-text.
   const isTextBox = Boolean(txbxContent);
 
-  const result: ShapeContent = { type: "shape", rawXml: drawingRawXml };
-  if (geometry) result.geometry = geometry;
+  const result: Mutable<ShapeContent> = { type: "shape", rawXml: drawingRawXml };
+  if (geometry) (result as Mutable<typeof result>).geometry = geometry;
   if (text) result.text = text;
-  if (fill) result.fill = fill;
-  if (line) result.line = line;
-  if (isTextBox) result.isTextBox = true;
-  if (textBoxBody) result.textBoxBody = textBoxBody;
-  if (txbxContentXml) result.txbxContentXml = txbxContentXml;
-  if (txbxBlocks && txbxBlocks.length > 0) result.txbxBlocks = txbxBlocks;
+  if (fill) (result as Mutable<typeof result>).fill = fill;
+  if (line) (result as Mutable<typeof result>).line = line;
+  if (isTextBox) (result as Mutable<typeof result>).isTextBox = true;
+  if (textBoxBody) (result as Mutable<typeof result>).textBoxBody = textBoxBody;
+  if (txbxContentXml) (result as Mutable<typeof result>).txbxContentXml = txbxContentXml;
+  if (txbxBlocks && txbxBlocks.length > 0) (result as Mutable<typeof result>).txbxBlocks = txbxBlocks;
   return result;
 }
 
@@ -310,7 +311,7 @@ function readTextBoxBody(wsp: XmlElementNode): TextBoxBodyProperties | undefined
   const bodyPr = findFirstChild(wsp, "bodyPr");
   if (!bodyPr) return undefined;
 
-  const result: TextBoxBodyProperties = {};
+  const result: Mutable<TextBoxBodyProperties> = {};
   const anchor = bodyPr.attributes.anchor;
   if (anchor === "t" || anchor === "ctr" || anchor === "b") {
     result.anchor = anchor;
@@ -319,9 +320,9 @@ function readTextBoxBody(wsp: XmlElementNode): TextBoxBodyProperties | undefined
   const top = readIntAttr(bodyPr, "tIns");
   const right = readIntAttr(bodyPr, "rIns");
   const bottom = readIntAttr(bodyPr, "bIns");
-  if (left !== undefined) result.insetLeftEmu = left;
-  if (top !== undefined) result.insetTopEmu = top;
-  if (right !== undefined) result.insetRightEmu = right;
+  if (left !== undefined) (result as Mutable<typeof result>).insetLeftEmu = left;
+  if (top !== undefined) (result as Mutable<typeof result>).insetTopEmu = top;
+  if (right !== undefined) (result as Mutable<typeof result>).insetRightEmu = right;
   if (bottom !== undefined) result.insetBottomEmu = bottom;
 
   return Object.keys(result).length > 0 ? result : undefined;