@beyondwork/docx-react-component 1.0.101 → 1.0.103

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;

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

@@ -23,6 +23,7 @@ import type {
   TableStyleDefinition,
   TableStyleFormatting,
   TableWidth,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import {
   readCellBorders,
@@ -372,8 +373,8 @@ function resolveStyleLinkReciprocals(
         );
         continue;
       }
-      if (partner.linkedStyleId === undefined) {
-        partner.linkedStyleId = style.styleId;
+      if ((partner as Mutable<typeof partner>).linkedStyleId === undefined) {
+        (partner as Mutable<typeof partner>).linkedStyleId = style.styleId;
       } else if (partner.linkedStyleId !== style.styleId) {
         diagnostics.push(
           `style ${label} "${style.styleId}" links to "${target}" but partner already links to "${partner.linkedStyleId}"; partner link retained`,
@@ -439,7 +440,7 @@ function readTableStyleFormatting(styleNode: XmlElementNode): TableStyleFormatti
   const cellProperties = findChildElementOptional(styleNode, "tcPr");
   const pPrNode = findChildElementOptional(styleNode, "pPr");
   const rPrNode = findChildElementOptional(styleNode, "rPr");
-  const formatting: TableStyleFormatting = {};
+  const formatting: Mutable<TableStyleFormatting> = {};
 
   const paragraphProperties = readParagraphProperties(pPrNode);
   if (paragraphProperties) formatting.paragraphProperties = paragraphProperties;
@@ -454,11 +455,11 @@ function readTableStyleFormatting(styleNode: XmlElementNode): TableStyleFormatti
     const cellMargins = readTableCellMargins(tableProperties);
     const tblLook = readTableLook(tableProperties);
 
-    if (width) table.width = width as TableWidth;
-    if (alignment) table.alignment = alignment;
-    if (borders) table.borders = borders as TableBorders;
-    if (cellMargins) table.cellMargins = cellMargins as TableCellMargins;
-    if (tblLook) table.tblLook = tblLook as TableLook;
+    if (width) (table as Mutable<typeof table>).width = width as TableWidth;
+    if (alignment) (table as Mutable<typeof table>).alignment = alignment;
+    if (borders) (table as Mutable<typeof table>).borders = borders as TableBorders;
+    if (cellMargins) (table as Mutable<typeof table>).cellMargins = cellMargins as TableCellMargins;
+    if (tblLook) (table as Mutable<typeof table>).tblLook = tblLook as TableLook;
 
     if (Object.keys(table).length > 0) {
       formatting.table = table;
@@ -471,9 +472,9 @@ function readTableStyleFormatting(styleNode: XmlElementNode): TableStyleFormatti
     const heightRule = readRowHeightRule(rowProperties);
     const isHeader = readRowIsHeader(rowProperties);
 
-    if (height !== undefined) row.height = height;
-    if (heightRule) row.heightRule = heightRule;
-    if (isHeader !== undefined) row.isHeader = isHeader;
+    if (height !== undefined) (row as Mutable<typeof row>).height = height;
+    if (heightRule) (row as Mutable<typeof row>).heightRule = heightRule;
+    if (isHeader !== undefined) (row as Mutable<typeof row>).isHeader = isHeader;
 
     if (Object.keys(row).length > 0) {
       formatting.row = row;
@@ -487,10 +488,10 @@ function readTableStyleFormatting(styleNode: XmlElementNode): TableStyleFormatti
     const shading = readCellShading(cellProperties);
     const verticalAlign = readCellVerticalAlign(cellProperties);
 
-    if (width) cell.width = width as TableWidth;
-    if (borders) cell.borders = borders as TableCellBorders;
-    if (shading) cell.shading = shading as CellShading;
-    if (verticalAlign) cell.verticalAlign = verticalAlign;
+    if (width) (cell as Mutable<typeof cell>).width = width as TableWidth;
+    if (borders) (cell as Mutable<typeof cell>).borders = borders as TableCellBorders;
+    if (shading) (cell as Mutable<typeof cell>).shading = shading as CellShading;
+    if (verticalAlign) (cell as Mutable<typeof cell>).verticalAlign = verticalAlign;
 
     if (Object.keys(cell).length > 0) {
       formatting.cell = cell;
@@ -590,4 +591,3 @@ function findChildElementOptional(
   );
 }
 
-

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

@@ -5,6 +5,7 @@ import type {
   ResolvedTheme,
   CanonicalTheme,
   ClrSchemeMapping,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import type { XmlElementNode } from "./xml-element.ts";
 import { parseXml } from "./xml-parser.ts";
@@ -61,7 +62,7 @@ export function parseThemeXml(xml: string): ThemeDefinition {
     findChildElementOptional(themeElements, "fontScheme"),
   );
 
-  const result: ThemeDefinition = {};
+  const result: Mutable<ThemeDefinition> = {};
   if (themeName) {
     result.name = themeName;
   }
@@ -79,7 +80,7 @@ export function parseThemeXml(xml: string): ThemeDefinition {
  * Resolve a ThemeDefinition into flattened runtime theme inputs.
  * Maps OOXML theme slot names to CSS-usable color values and font families.
  */
-export function resolveTheme(theme: ThemeDefinition): ResolvedTheme {
+export function resolveTheme(theme: Mutable<ThemeDefinition>): ResolvedTheme {
   const colors: Record<string, string> = {};
 
   if (theme.colorScheme?.colors) {
@@ -142,7 +143,7 @@ export const DEFAULT_CLR_SCHEME_MAPPING: ClrSchemeMapping = Object.freeze({
  * CLAUDE.md §3.
  */
 export function materializeCanonicalTheme(
-  theme: ThemeDefinition,
+  theme: Mutable<ThemeDefinition>,
   clrMap: ClrSchemeMapping,
 ): CanonicalTheme {
   const clrScheme: ThemeColorScheme = theme.colorScheme ?? { name: "", colors: {} };
@@ -240,7 +241,7 @@ function parseFontScheme(
     ? extractFontTypeface(minorFontElement)
     : undefined;
 
-  const result: ThemeFontScheme = { name: schemeName };
+  const result: Mutable<ThemeFontScheme> = { name: schemeName };
   if (majorFont) {
     result.majorFont = majorFont;
   }