@beyondwork/docx-react-component 1.0.102 → 1.0.103

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@beyondwork/docx-react-component",
   "publisher": "beyondwork",
-  "version": "1.0.102",
+  "version": "1.0.103",
   "description": "Embeddable React Word (docx) editor with review, comments, tracked changes, and round-trip OOXML fidelity.",
   "type": "module",
   "sideEffects": [

package/src/core/commands/formatting-commands.ts

@@ -37,6 +37,7 @@ import type {
   ParagraphNode,
   TextMark,
   TextNode,
+  Mutable,
 } from "../../model/canonical-document.ts";
 
 // ---------------------------------------------------------------------------
@@ -659,7 +660,7 @@ export function applyTextMarkOperationToDocumentRange(
         updateMarks,
       );
       if (transformed.changed) {
-        block.children = transformed.nodes;
+        (block as Mutable<typeof block>).children = transformed.nodes;
         changed = true;
       }
     }
@@ -862,7 +863,7 @@ function resolveMarkUpdater(
 }
 
 function applyAlignment(
-  paragraph: ParagraphNode,
+  paragraph: Mutable<ParagraphNode>,
   alignment: FormattingAlignment,
 ): boolean {
   const nextAlignment = alignment === "justify" ? "both" : alignment;
@@ -880,7 +881,7 @@ function applyAlignment(
  * must clone first if the source is shared. Returns `false` when no change
  * occurred (already at the 0 / 8 bound, or no-op).
  */
-export function applyIndentation(paragraph: ParagraphNode, delta: -1 | 1): boolean {
+export function applyIndentation(paragraph: Mutable<ParagraphNode>, delta: -1 | 1): boolean {
   if (paragraph.numbering) {
     const nextLevel = clamp(paragraph.numbering.level + delta, 0, 8);
     if (nextLevel === paragraph.numbering.level) {
@@ -904,10 +905,10 @@ export function applyIndentation(paragraph: ParagraphNode, delta: -1 | 1): boole
     ...(paragraph.indentation ?? {}),
   };
   if (nextLeft > 0) {
-    nextIndentation.left = nextLeft;
+    (nextIndentation as Mutable<typeof nextIndentation>).left = nextLeft;
     paragraph.indentation = nextIndentation;
   } else if (paragraph.indentation) {
-    delete nextIndentation.left;
+    delete (nextIndentation as Mutable<typeof nextIndentation>).left;
     paragraph.indentation =
       Object.keys(nextIndentation).length > 0 ? nextIndentation : undefined;
   }
@@ -1042,7 +1043,7 @@ function getConsistentValue<TItem, TValue>(
 function visitParagraphBindings(
   blocks: BlockNode[],
   surfaceBlocks: SurfaceBlockSnapshot[],
-  visitor: (paragraph: ParagraphNode, surface: ParagraphSurfaceBlock) => void,
+  visitor: (paragraph: Mutable<ParagraphNode>, surface: ParagraphSurfaceBlock) => void,
 ): void {
   for (let index = 0; index < Math.min(blocks.length, surfaceBlocks.length); index += 1) {
     const block = blocks[index];
@@ -1146,7 +1147,7 @@ function transformInlineNodes(
 }
 
 function transformTextNode(
-  node: TextNode,
+  node: Mutable<TextNode>,
   start: number,
   selectionFrom: number,
   selectionTo: number,

package/src/core/commands/paragraph-layout-commands.ts

@@ -11,6 +11,7 @@ import type {
   TableCellNode,
   TableNode,
   TableRowNode,
+  Mutable,
 } from "../../model/canonical-document.ts";
 
 export interface ParagraphLayoutCommandContext {
@@ -26,7 +27,7 @@ export interface ParagraphLayoutMutationResult {
 export function setActiveParagraphIndentation(
   document: CanonicalDocumentEnvelope,
   snapshot: RuntimeRenderSnapshot,
-  indentation: ParagraphIndentation,
+  indentation: Mutable<ParagraphIndentation>,
   _context: ParagraphLayoutCommandContext,
 ): ParagraphLayoutMutationResult {
   return mutateActiveParagraph(document, snapshot, (paragraph) => {
@@ -66,7 +67,7 @@ export function setActiveParagraphTabStops(
 function mutateActiveParagraph(
   document: CanonicalDocumentEnvelope,
   snapshot: RuntimeRenderSnapshot,
-  mutate: (paragraph: ParagraphNode) => boolean,
+  mutate: (paragraph: Mutable<ParagraphNode>) => boolean,
 ): ParagraphLayoutMutationResult {
   const surface = snapshot.surface;
   if (!surface) {
@@ -190,27 +191,27 @@ function collectCanonicalParagraphs(
   return output;
 }
 
-function collectParagraphsFromTable(table: TableNode, output: ParagraphNode[]): void {
+function collectParagraphsFromTable(table: Mutable<TableNode>, output: ParagraphNode[]): void {
   for (const row of table.rows) {
     collectParagraphsFromRow(row, output);
   }
 }
 
-function collectParagraphsFromRow(row: TableRowNode, output: ParagraphNode[]): void {
+function collectParagraphsFromRow(row: Mutable<TableRowNode>, output: ParagraphNode[]): void {
   for (const cell of row.cells) {
     collectParagraphsFromCell(cell, output);
   }
 }
 
-function collectParagraphsFromCell(cell: TableCellNode, output: ParagraphNode[]): void {
+function collectParagraphsFromCell(cell: Mutable<TableCellNode>, output: ParagraphNode[]): void {
   collectCanonicalParagraphs(cell.children, output);
 }
 
 function mergeIndentationPatch(
   current: ParagraphIndentation | undefined,
-  patch: ParagraphIndentation,
+  patch: Mutable<ParagraphIndentation>,
 ): ParagraphIndentation | undefined {
-  const merged: ParagraphIndentation = {
+  const merged: Mutable<ParagraphIndentation> = {
     ...(current ?? {}),
   };
 
@@ -237,9 +238,9 @@ function mergeIndentationPatch(
 }
 
 function normalizeIndentation(
-  indentation: ParagraphIndentation,
+  indentation: Mutable<ParagraphIndentation>,
 ): ParagraphIndentation | undefined {
-  const normalized: ParagraphIndentation = {};
+  const normalized: Mutable<ParagraphIndentation> = {};
   if (indentation.left !== undefined && indentation.left > 0) {
     normalized.left = Math.round(indentation.left);
   }
@@ -250,7 +251,7 @@ function normalizeIndentation(
     normalized.firstLine = Math.round(indentation.firstLine);
   }
   if (indentation.hanging !== undefined && indentation.hanging > 0) {
-    normalized.hanging = Math.round(indentation.hanging);
+    (normalized as Mutable<typeof normalized>).hanging = Math.round(indentation.hanging);
     delete normalized.firstLine;
   }
   return Object.keys(normalized).length > 0 ? normalized : undefined;

package/src/core/commands/section-layout-commands.ts

@@ -21,6 +21,7 @@ import type {
   PageSize,
   SectionBreakNode,
   SectionProperties,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import type {
   MarginPresetDefinition,
@@ -145,7 +146,7 @@ export function insertSectionBreak(
 
   const sectionTarget = resolveSectionTarget(cloned, surface.blocks, position);
   const inheritedProperties = cloneSectionProperties(sectionTarget?.properties);
-  const sectionBreak: SectionBreakNode = {
+  const sectionBreak: Mutable<SectionBreakNode> = {
     type: "section_break",
     sectionProperties: {
       ...inheritedProperties,
@@ -178,7 +179,7 @@ export function insertSectionBreakAfterSectionIndex(
   const inheritedProperties = cloneSectionProperties(
     getSectionPropertiesAtIndex(cloned, sectionIndex),
   );
-  const sectionBreak: SectionBreakNode = {
+  const sectionBreak: Mutable<SectionBreakNode> = {
     type: "section_break",
     sectionProperties: {
       ...inheritedProperties,
@@ -364,9 +365,9 @@ export function setSectionPageNumberingAtSectionIndex(
 
   const nextProperties = cloneSectionProperties(target.properties);
   if (pageNumbering === null) {
-    delete nextProperties.pageNumbering;
+    delete (nextProperties as Mutable<typeof nextProperties>).pageNumbering;
   } else {
-    nextProperties.pageNumbering = {
+    (nextProperties as Mutable<typeof nextProperties>).pageNumbering = {
       ...(target.properties?.pageNumbering ?? {}),
       ...pageNumbering,
     };
@@ -683,10 +684,10 @@ function findNearestSectionBreak(
 }
 
 function applySectionLayoutPatch(
-  existing: SectionProperties,
+  existing: Mutable<SectionProperties>,
   patch: SectionLayoutPatch,
 ): SectionProperties {
-  const result: SectionProperties = { ...existing };
+  const result: Mutable<SectionProperties> = { ...existing };
 
   if (patch.pageSize) {
     result.pageSize = {

package/src/core/commands/style-commands.ts

@@ -8,6 +8,7 @@ import type {
   DocumentRootNode,
   ParagraphNode,
   TableNode,
+  Mutable,
 } from "../../model/canonical-document.ts";
 
 type CanonicalDocumentEnvelope = PersistedEditorSnapshot["canonicalDocument"];
@@ -161,7 +162,7 @@ function isValidTableStyleId(
 function visitParagraphBindings(
   blocks: BlockNode[],
   surfaceBlocks: SurfaceBlockSnapshot[],
-  visitor: (paragraph: ParagraphNode, surface: Extract<SurfaceBlockSnapshot, { kind: "paragraph" }>) => void,
+  visitor: (paragraph: Mutable<ParagraphNode>, surface: Extract<SurfaceBlockSnapshot, { kind: "paragraph" }>) => void,
 ): void {
   for (let index = 0; index < Math.min(blocks.length, surfaceBlocks.length); index += 1) {
     const block = blocks[index];
@@ -203,7 +204,7 @@ function visitParagraphBindings(
 function visitTableBindings(
   blocks: BlockNode[],
   surfaceBlocks: SurfaceBlockSnapshot[],
-  visitor: (table: TableNode, surface: Extract<SurfaceBlockSnapshot, { kind: "table" }>) => void,
+  visitor: (table: Mutable<TableNode>, surface: Extract<SurfaceBlockSnapshot, { kind: "table" }>) => void,
 ): void {
   for (let index = 0; index < Math.min(blocks.length, surfaceBlocks.length); index += 1) {
     const block = blocks[index];

package/src/io/normalize/normalize-text.ts

@@ -18,6 +18,7 @@ import type {
   TextMark,
   TextNode,
   SdtNode,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import type {
   ParsedAltChunkNode,
@@ -108,7 +109,7 @@ export function normalizeParsedTextDocument(
     }
   }
 
-  const content: DocumentRootNode = { type: "doc", children };
+  const content: Mutable<DocumentRootNode> = { type: "doc", children };
 
   return {
     content,
@@ -180,7 +181,7 @@ export async function normalizeParsedTextDocumentAsync(
     }
   }
 
-  const content: DocumentRootNode = { type: "doc", children };
+  const content: Mutable<DocumentRootNode> = { type: "doc", children };
 
   return {
     content,
@@ -432,7 +433,7 @@ function normalizeInlineChildren(
 
         const previous = normalized[normalized.length - 1];
         if (previous?.type === "text" && sameMarks(previous.marks, node.marks)) {
-          previous.text += node.text;
+          (previous as Mutable<typeof previous>).text += node.text;
         } else {
           normalized.push({
             type: "text",
@@ -752,7 +753,7 @@ function normalizeHyperlink(node: ParsedHyperlinkNode): {
         }
         const previous = children[children.length - 1];
         if (previous?.type === "text" && sameMarks(previous.marks, child.marks)) {
-          previous.text += child.text;
+          (previous as Mutable<typeof previous>).text += child.text;
         } else {
           children.push({
             type: "text",
@@ -835,7 +836,7 @@ function recordOpaqueFragment(
   const rangeStart = state.cursor;
   const rangeEnd = state.cursor + 1;
 
-  const record: OpaqueFragmentRecord = {
+  const record: Mutable<OpaqueFragmentRecord> = {
     fragmentId,
     payloadKind: "xml-subtree",
     payloadReference: rawXml,

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

@@ -1,4 +1,4 @@
-import type { AnchorGeometry } from "../../model/canonical-document.ts";
+import type { AnchorGeometry, Mutable } from "../../model/canonical-document.ts";
 import {
   type XmlElementNode,
   findFirstChild,
@@ -46,11 +46,11 @@ export function parseAnchorGeometry(container: XmlElementNode): AnchorGeometry {
         const dp: NonNullable<AnchorGeometry["docPr"]> = {
           id: docPrEl.attributes.id ?? "",
         };
-        if (docPrEl.attributes.name) dp.name = docPrEl.attributes.name;
-        if (docPrEl.attributes.descr) dp.descr = docPrEl.attributes.descr;
+        if (docPrEl.attributes.name) (dp as Mutable<typeof dp>).name = docPrEl.attributes.name;
+        if (docPrEl.attributes.descr) (dp as Mutable<typeof dp>).descr = docPrEl.attributes.descr;
         // Phase 4.6 G8 — wp:docPr hidden flag
         const hidden = readBoolAttr(docPrEl, "hidden");
-        if (hidden !== undefined) dp.hidden = hidden;
+        if (hidden !== undefined) (dp as Mutable<typeof dp>).hidden = hidden;
         return dp;
       })()
     : undefined;
@@ -62,21 +62,21 @@ export function parseAnchorGeometry(container: XmlElementNode): AnchorGeometry {
   // Phase 4.2 G1 — wrapPolygon coords for wrapTight / wrapThrough.
   const wrapPolygon = readWrapPolygon(container);
 
-  const geometry: AnchorGeometry = {
+  const geometry: Mutable<AnchorGeometry> = {
     display,
     extent,
     wrapMode,
   };
 
-  if (wrapPolygon) geometry.wrapPolygon = wrapPolygon;
-  if (positionHEl) geometry.positionH = readAxisPosition(positionHEl);
-  if (positionVEl) geometry.positionV = readAxisPosition(positionVEl);
-  if (distMargins) geometry.distMargins = distMargins;
-  if (relativeHeight !== undefined) geometry.relativeHeight = relativeHeight;
-  if (behindDoc !== undefined) geometry.behindDoc = behindDoc;
-  if (layoutInCell !== undefined) geometry.layoutInCell = layoutInCell;
-  if (allowOverlap !== undefined) geometry.allowOverlap = allowOverlap;
-  if (simplePos !== undefined) geometry.simplePos = simplePos;
+  if (wrapPolygon) (geometry as Mutable<typeof geometry>).wrapPolygon = wrapPolygon;
+  if (positionHEl) (geometry as Mutable<typeof geometry>).positionH = readAxisPosition(positionHEl);
+  if (positionVEl) (geometry as Mutable<typeof geometry>).positionV = readAxisPosition(positionVEl);
+  if (distMargins) (geometry as Mutable<typeof geometry>).distMargins = distMargins;
+  if (relativeHeight !== undefined) (geometry as Mutable<typeof geometry>).relativeHeight = relativeHeight;
+  if (behindDoc !== undefined) (geometry as Mutable<typeof geometry>).behindDoc = behindDoc;
+  if (layoutInCell !== undefined) (geometry as Mutable<typeof geometry>).layoutInCell = layoutInCell;
+  if (allowOverlap !== undefined) (geometry as Mutable<typeof geometry>).allowOverlap = allowOverlap;
+  if (simplePos !== undefined) (geometry as Mutable<typeof geometry>).simplePos = simplePos;
   if (docPr) geometry.docPr = docPr;
   if (frameLocks) geometry.frameLocks = frameLocks;
 
@@ -136,7 +136,7 @@ function readFrameLocks(
   const keys = ["noChangeAspect", "noResize", "noMove", "noRot", "noSelect", "noGrp"] as const;
   for (const key of keys) {
     const v = readBoolAttr(locks, key);
-    if (v !== undefined) result[key] = v;
+    if (v !== undefined) (result as Mutable<typeof result>)[key] = v;
   }
   return Object.keys(result).length > 0 ? result : undefined;
 }

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

@@ -2,7 +2,7 @@ import type { OpcRelationship } from "./part-manifest.ts";
 import { normalizePartPath, resolveRelationshipTarget } from "./part-manifest.ts";
 import type { InlineMediaPart } from "./parse-inline-media.ts";
 import type { ChartPartLookup } from "./parse-complex-content.ts";
-import type { DrawingFrameNode, AnchorGeometry } from "../../model/canonical-document.ts";
+import type { AnchorGeometry, DrawingFrameNode, Mutable } from "../../model/canonical-document.ts";
 import { parseAnchorGeometry } from "./parse-anchor.ts";
 import { parsePicture } from "./parse-picture.ts";
 import { parseShapeContent, type TxbxBlockParser } from "./parse-shapes.ts";
@@ -190,14 +190,14 @@ function resolveContent(
             resolveRelationshipTarget(opts.sourcePartPath ?? "/word/document.xml", rel),
           );
           const mediaPart = opts.mediaParts?.get(partPath);
-          pic.packagePartName = partPath;
-          pic.mediaId = `media:${partPath.slice(1)}`;
+          (pic as Mutable<typeof pic>).packagePartName = partPath;
+          (pic as Mutable<typeof pic>).mediaId = `media:${partPath.slice(1)}`;
           if (mediaPart?.contentType) {
-            pic.contentType = mediaPart.contentType;
+            (pic as Mutable<typeof pic>).contentType = mediaPart.contentType;
           }
         }
         // F4.1 — preserve outer drawing XML for lossless round-trip serialization
-        pic.rawXml = rawXml;
+        (pic as Mutable<typeof pic>).rawXml = rawXml;
         return pic;
       }
     }

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

@@ -328,6 +328,7 @@ import type {
   TocInstructionModel,
   TocRegion,
   TocStructure,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import { parseFieldSwitches } from "./parse-field-switches.ts";
 
@@ -379,14 +380,14 @@ export function classifyFieldInstruction(instruction: string): {
   let switches: FieldNode["switches"] | undefined;
   if (family === "REF" || family === "PAGEREF" || family === "NOTEREF" || family === "TOC") {
     const raw = parseFieldSwitches(trimmed);
-    const sw: FieldNode["switches"] = {};
-    if (raw.hyperlink) sw.hyperlink = true;
-    if (raw.relativePosition) sw.relativePosition = true;
-    if (raw.numericRef) sw.numericRef = true;
-    if (raw.recursive) sw.recursive = true;
-    if (raw.suppressNonDelimiter) sw.suppressNonDelimiter = true;
-    if (raw.includeNumbering) sw.includeNumbering = true;
-    if (raw.includeLevel) sw.includeLevel = true;
+    const sw: Mutable<NonNullable<FieldNode["switches"]>> = {};
+    if (raw.hyperlink) (sw as Mutable<typeof sw>).hyperlink = true;
+    if (raw.relativePosition) (sw as Mutable<typeof sw>).relativePosition = true;
+    if (raw.numericRef) (sw as Mutable<typeof sw>).numericRef = true;
+    if (raw.recursive) (sw as Mutable<typeof sw>).recursive = true;
+    if (raw.suppressNonDelimiter) (sw as Mutable<typeof sw>).suppressNonDelimiter = true;
+    if (raw.includeNumbering) (sw as Mutable<typeof sw>).includeNumbering = true;
+    if (raw.includeLevel) (sw as Mutable<typeof sw>).includeLevel = true;
     if (Object.keys(sw).length > 0) {
       switches = sw;
     }
@@ -430,7 +431,7 @@ export function buildFieldRegistry(
         ? { family: node.fieldFamily, supported: isSupportedFieldFamily(node.fieldFamily), target: node.fieldTarget, switches: node.switches }
         : classifyFieldInstruction(node.instruction);
       const displayText = flattenFieldText(node.children);
-      const entry: FieldRegistryEntry = {
+      const entry: Mutable<FieldRegistryEntry> = {
         fieldIndex,
         fieldFamily: classification.family,
         supported: classification.supported,
@@ -460,7 +461,7 @@ export function buildFieldRegistry(
           ? { family: node.fieldFamily, supported: isSupportedFieldFamily(node.fieldFamily), target: node.fieldTarget, switches: node.switches }
           : classifyFieldInstruction(node.instruction);
         const displayText = flattenFieldText(node.children);
-        const entry: FieldRegistryEntry = {
+        const entry: Mutable<FieldRegistryEntry> = {
           fieldIndex,
           fieldFamily: classification.family,
           supported: classification.supported,
@@ -512,7 +513,7 @@ export function parseTocLevelRange(instruction: string): { from: number; to: num
 }
 
 export function parseTocInstruction(instruction: string): TocInstructionModel {
-  const model: TocInstructionModel = {
+  const model: Mutable<TocInstructionModel> = {
     raw: instruction,
     outlineRange: { from: 1, to: 9 },
   };
@@ -867,7 +868,7 @@ function tocLevelFromStyle(styleId: string | undefined): number {
 }
 
 function extractCachedTocEntry(
-  paragraph: ParagraphNode,
+  paragraph: Mutable<ParagraphNode>,
   paragraphIndexByNode: WeakMap<ParagraphNode, number>,
 ): TocCachedEntry | undefined {
   if (!isTocParagraphStyle(paragraph.styleId)) {
@@ -1004,7 +1005,7 @@ export function resolveRefFieldText(
  * applies these to the live document.
  */
 export function refreshFieldRegistry(
-  registry: FieldRegistry,
+  registry: Mutable<FieldRegistry>,
   bookmarkNameMap: Map<string, { bookmarkId: string; paragraphIndex: number }>,
 ): FieldRegistry {
   const refreshed: FieldRegistryEntry[] = registry.supported.map((entry) => {
@@ -1060,7 +1061,7 @@ function walkFieldDocument(
 }
 
 function walkSubPartFields(
-  subParts: SubPartsCatalog,
+  subParts: Mutable<SubPartsCatalog>,
   visit: (node: DocumentNode, paragraphIndex: number) => void,
 ): void {
   for (const header of subParts.headers) {
@@ -1112,7 +1113,7 @@ function flattenParagraphInlineText(children: InlineNode[]): string {
 }
 
 function flattenBookmarkContent(
-  paragraph: ParagraphNode,
+  paragraph: Mutable<ParagraphNode>,
   bookmarkId: string,
 ): string {
   let inside = false;

package/src/io/ooxml/parse-font-table.ts

@@ -13,6 +13,7 @@
 import type {
   CanonicalFontEntry,
   CanonicalFontTable,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import type { XmlElementNode } from "./xml-element.ts";
 import { parseXml } from "./xml-parser.ts";
@@ -32,7 +33,7 @@ export function parseFontTable(xml: string): CanonicalFontTable {
     const name = child.attributes["w:name"] ?? child.attributes["name"];
     if (!name) continue;
 
-    const entry: CanonicalFontEntry = { name };
+    const entry: Mutable<CanonicalFontEntry> = { name };
 
     for (const sub of child.children) {
       if (sub.type !== "element") continue;

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

@@ -11,6 +11,7 @@ import type {
   TableNode,
   TableRowNode,
   TextMark,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import { classifyFieldInstruction } from "./parse-fields.ts";
 import { isSafeTableFieldInstruction } from "./table-opaque-preservation.ts";
@@ -644,7 +645,7 @@ function parseRunProperties(rElement: XmlElementNode): TextMark[] {
 function readParagraphSpacing(pPr: XmlElementNode): ParagraphSpacing | undefined {
   const spacingNode = findChildElementOptional(pPr, "spacing");
   if (!spacingNode) return undefined;
-  const result: ParagraphSpacing = {};
+  const result: Mutable<ParagraphSpacing> = {};
   const before = readStringAttr(spacingNode, "w:before");
   if (before) result.before = Number.parseInt(before, 10);
   const after = readStringAttr(spacingNode, "w:after");
@@ -661,7 +662,7 @@ function readParagraphSpacing(pPr: XmlElementNode): ParagraphSpacing | undefined
 function readParagraphIndentation(pPr: XmlElementNode): ParagraphIndentation | undefined {
   const indNode = findChildElementOptional(pPr, "ind");
   if (!indNode) return undefined;
-  const result: ParagraphIndentation = {};
+  const result: Mutable<ParagraphIndentation> = {};
   const left = readStringAttr(indNode, "w:left");
   if (left) result.left = Number.parseInt(left, 10);
   const right = readStringAttr(indNode, "w:right");

package/src/io/ooxml/parse-headers-footers.ts

@@ -11,6 +11,7 @@ import type {
   TableNode,
   TableRowNode,
   TextMark,
+  Mutable,
 } from "../../model/canonical-document.ts";
 import type { LegacyFormFieldNode } from "../../model/canonical-document.ts";
 import { resolveHighlightColor } from "./highlight-colors.ts";
@@ -500,7 +501,7 @@ function parseRunElement(
       const noteId =
         readStringAttr(child, "w:id") ?? "";
       if (noteId) {
-        const ref: FootnoteRefNode = {
+        const ref: Mutable<FootnoteRefNode> = {
           type: "footnote_ref",
           noteId,
           noteKind: "footnote",
@@ -511,7 +512,7 @@ function parseRunElement(
       const noteId =
         readStringAttr(child, "w:id") ?? "";
       if (noteId) {
-        const ref: FootnoteRefNode = {
+        const ref: Mutable<FootnoteRefNode> = {
           type: "footnote_ref",
           noteId,
           noteKind: "endnote",
@@ -594,7 +595,7 @@ function parseRunChildNode(
     const noteId =
       readStringAttr(child, "w:id") ?? "";
     if (noteId) {
-      const ref: FootnoteRefNode = {
+      const ref: Mutable<FootnoteRefNode> = {
         type: "footnote_ref",
         noteId,
         noteKind: "footnote",
@@ -607,7 +608,7 @@ function parseRunChildNode(
     const noteId =
       readStringAttr(child, "w:id") ?? "";
     if (noteId) {
-      const ref: FootnoteRefNode = {
+      const ref: Mutable<FootnoteRefNode> = {
         type: "footnote_ref",
         noteId,
         noteKind: "endnote",
@@ -970,7 +971,7 @@ function parseRunProperties(rElement: XmlElementNode): TextMark[] {
 function readParagraphSpacing(pPr: XmlElementNode): ParagraphSpacing | undefined {
   const spacingNode = findChildElementOptional(pPr, "spacing");
   if (!spacingNode) return undefined;
-  const result: ParagraphSpacing = {};
+  const result: Mutable<ParagraphSpacing> = {};
   const before = readStringAttr(spacingNode, "w:before");
   if (before) result.before = Number.parseInt(before, 10);
   const after = readStringAttr(spacingNode, "w:after");
@@ -987,7 +988,7 @@ function readParagraphSpacing(pPr: XmlElementNode): ParagraphSpacing | undefined
 function readParagraphIndentation(pPr: XmlElementNode): ParagraphIndentation | undefined {
   const indNode = findChildElementOptional(pPr, "ind");
   if (!indNode) return undefined;
-  const result: ParagraphIndentation = {};
+  const result: Mutable<ParagraphIndentation> = {};
   const left = readStringAttr(indNode, "w:left");
   if (left) result.left = Number.parseInt(left, 10);
   const right = readStringAttr(indNode, "w:right");