@beyondwork/docx-react-component 1.0.102 → 1.0.104

package/package.json

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

package/src/api/public-types.ts

@@ -1223,6 +1223,23 @@ export interface SurfacePictureEffects {
   glow?: { radius: number; color: string; colorType: "srgbClr" | "schemeClr" };
 }
 
+export interface SurfacePreserveOnlyObjectSizing {
+  sourceId?: string;
+  display: "inline" | "floating" | "unknown";
+  extentEmu?: { widthEmu: number; heightEmu: number };
+  fallbackHint:
+    | "drawing-inline"
+    | "drawing-floating"
+    | "chart"
+    | "smartart"
+    | "shape"
+    | "wordart"
+    | "vml-shape"
+    | "ole-object"
+    | "opaque-object";
+  relationshipIds?: string[];
+}
+
 export type SurfaceInlineSegment =
   | {
       segmentId: string;
@@ -1338,6 +1355,20 @@ export type SurfaceInlineSegment =
        * can render `ChartSurface` instead of the fallback bitmap or badge.
        */
       parsedChartId?: string;
+      /**
+       * PE2 preserve-only object handoff. Present for unsupported drawing,
+       * chart, SmartArt, WordArt, VML, and opaque-object previews when import
+       * could recover source ids, relationship ids, fallback hints, or
+       * extents. Layout consumers may size placeholders from this metadata;
+       * it is not a layout computation.
+       */
+      preserveOnlyObject?: SurfacePreserveOnlyObjectSizing;
+      /**
+       * Drawing anchor geometry for preserve-only objects that originated in a
+       * `drawing_frame`. Mirrors image/shape anchor semantics so L04 can join
+       * the object to source/canonical/layout rows without re-parsing OOXML.
+       */
+      anchor?: SurfaceDrawingAnchor;
       state: "locked-preserve-only";
     }
   | {
@@ -1403,6 +1434,7 @@ export type SurfaceInlineSegment =
       isTextBox?: boolean;
       /** Text box body layout from `wps:bodyPr` / `a:bodyPr`. */
       textBoxBody?: SurfaceTextBoxBodyProperties;
+      preserveOnlyObject?: SurfacePreserveOnlyObjectSizing;
       /** First-paragraph plain-text preview when `isTextBox` is true. */
       txbxText?: string;
       /** Run-level marks from the first text-box text run, when available. */
@@ -3609,6 +3641,11 @@ export interface WordReviewEditorPasteEvent {
   source: "paste" | "drop";
 }
 
+export interface WorkflowEventOrigin {
+  readonly source: "api" | "runtime" | "collab" | string;
+  readonly at?: string;
+}
+
 export type WordReviewEditorEvent =
   | {
       type: "ready";
@@ -3724,16 +3761,38 @@ export type WordReviewEditorEvent =
       type: "workflow_overlay_changed";
       documentId: string;
       snapshot: WorkflowScopeSnapshot;
+      origin?: WorkflowEventOrigin;
     }
   | {
       type: "workflow_active_work_item_changed";
       documentId: string;
       activeWorkItemId: string | null;
+      origin?: WorkflowEventOrigin;
     }
   | {
       type: "workflow_metadata_changed";
       documentId: string;
       snapshot: WorkflowMetadataSnapshot;
+      origin?: WorkflowEventOrigin;
+    }
+  | {
+      type: "workflow_shared_state_changed";
+      documentId: string;
+      state: SharedWorkflowState | null;
+      origin: WorkflowEventOrigin;
+    }
+  | {
+      type: "workflow_visibility_policy_changed";
+      documentId: string;
+      kind?: OverlayKind;
+      policy?: OverlayVisibilityPolicy | null;
+      origin: WorkflowEventOrigin;
+    }
+  | {
+      type: "workflow_markup_mode_policy_changed";
+      documentId: string;
+      policy: WorkflowMarkupModePolicy | null;
+      origin: WorkflowEventOrigin;
     }
   | {
       type: "host_annotation_overlay_changed";
@@ -5010,7 +5069,10 @@ export interface WordReviewEditorRef {
    * `replaceText` calls to block with `workflow_comment_only`.
    */
   getWorkflowOverlay(): WorkflowOverlay | null;
-  setSharedWorkflowState(state: SharedWorkflowState | null): void;
+  setSharedWorkflowState(
+    state: SharedWorkflowState | null,
+    origin?: WorkflowEventOrigin,
+  ): void;
   getWorkflowScopeSnapshot(): WorkflowScopeSnapshot | null;
   getInteractionGuardSnapshot(): InteractionGuardSnapshot;
   getWorkflowMarkupSnapshot(): WorkflowMarkupSnapshot;

package/src/api/v3/_runtime-handle.ts

@@ -48,6 +48,7 @@ export type RuntimeApiHandle = Pick<
   | "getCompatibilityReport"
   | "getWarnings"
   | "getRenderSnapshot"
+  | "getDocumentNavigationSnapshot"
   // Canonical document read (ai.inspect + ai.bundle + ai.resolve families,
   // added in refactor/08 Slice 2/3 graduations)
   | "getCanonicalDocument"
@@ -155,6 +156,7 @@ export const RUNTIME_API_HANDLE_SHAPE_CHECK: Record<keyof RuntimeApiHandle, true
   getCompatibilityReport: true,
   getWarnings: true,
   getRenderSnapshot: true,
+  getDocumentNavigationSnapshot: true,
   getCanonicalDocument: true,
   findAllText: true,
   replaceText: true,

package/src/api/v3/ai/outline.ts

@@ -19,7 +19,6 @@ import type {
   DocumentOutlineHeadingSnapshot,
   DocumentOutlineSnapshot,
 } from "../../public-types.ts";
-import { createDocumentNavigationSnapshot } from "../../../runtime/document-navigation.ts";
 import { createDocumentOutlineSnapshot } from "../../../runtime/document-outline.ts";
 import {
   computeBlockPositions,
@@ -68,7 +67,7 @@ export const getDocumentOutlineMetadata: ApiV3FnMetadata = {
   stateClass: "A-canonical",
   persistsTo: "canonical",
   rwdReference:
-    "§AI API § ai.getDocumentOutline. Composes createDocumentNavigationSnapshot (L04/07) with createDocumentOutlineSnapshot (L07) to surface the heading tree. Read-only; no audit emission.",
+    "§AI API § ai.getDocumentOutline. Composes runtime.getDocumentNavigationSnapshot() (L04 graph-derived navigation) with createDocumentOutlineSnapshot (L07) to surface the heading tree. Read-only; no audit emission.",
 };
 
 export function createOutlineFamily(runtime: RuntimeApiHandle) {
@@ -82,11 +81,7 @@ export function createOutlineFamily(runtime: RuntimeApiHandle) {
       const snapshot = runtime.getRenderSnapshot();
       const document = runtime.getCanonicalDocument();
       const selectionHead = snapshot.selection.head;
-      const navigation = createDocumentNavigationSnapshot(
-        document,
-        selectionHead,
-        snapshot.activeStory,
-      );
+      const navigation = runtime.getDocumentNavigationSnapshot();
       const outline = createDocumentOutlineSnapshot({
         navigation,
         activeStory: snapshot.activeStory,

package/src/api/v3/runtime/geometry.ts

@@ -15,6 +15,26 @@ import type { RuntimeApiHandle } from "../_runtime-handle.ts";
 import type { ApiV3FnMetadata } from "../_layer-metadata.ts";
 import { mockPayload } from "../_mocks.ts";
 import type { MockPayload } from "../_layer-metadata.ts";
+import type {
+  GeometryIndex,
+  GeometryIndexCoverage,
+} from "../../../runtime/geometry/index.ts";
+
+function createUnavailableGeometryCoverage(): GeometryIndexCoverage {
+  return {
+    status: "unavailable",
+    pageCount: 0,
+    regionCount: 0,
+    sliceCount: 0,
+    lineCount: 0,
+    anchorCount: 0,
+    hitTargetCount: 0,
+    semanticEntryCount: 0,
+    replacementEnvelopeCount: 0,
+    objectHandleCount: 0,
+    precision: { exact: 0, "within-tolerance": 0, heuristic: 0 },
+  };
+}
 
 export interface BlockRectEntry {
   readonly blockId: string;
@@ -57,6 +77,50 @@ export interface HitTestResult {
   readonly __mock?: true;
 }
 
+/* ================================================================== */
+/*  PE2 geometry index + coverage                                     */
+/* ================================================================== */
+
+export const getGeometryIndexMetadata: ApiV3FnMetadata = {
+  name: "runtime.geometry.getGeometryIndex",
+  status: "live-with-adapter",
+  sourceLayer: "geometry-projection",
+  liveEvidence: {
+    runnerTest: "test/api/v3/geometry-uses-geometry-handle.test.ts",
+    commit: "refactor-07-pe2-geometry-index-read-surface",
+  },
+  uxIntent: { uiVisible: false, expectsUxResponse: "none" },
+  agentMetadata: {
+    readOrMutate: "read",
+    boundedScope: "document",
+    auditCategory: "geometry-read",
+  },
+  stateClass: "A-canonical",
+  persistsTo: "canonical",
+  rwdReference:
+    "§Runtime API § runtime.geometry.getGeometryIndex. PE2 read surface over GeometryFacet.getGeometryIndex(): renderer-neutral pages, regions, slices, lines, anchors, hit targets, semantic entries, replacement envelopes, object handles, and coverage. Returns null when no geometry facet or render frame is warm. Promotes to live when L05 projects directly from L04 page slices instead of the render-frame adapter.",
+};
+
+export const getGeometryCoverageMetadata: ApiV3FnMetadata = {
+  name: "runtime.geometry.getGeometryCoverage",
+  status: "live-with-adapter",
+  sourceLayer: "geometry-projection",
+  liveEvidence: {
+    runnerTest: "test/api/v3/geometry-uses-geometry-handle.test.ts",
+    commit: "refactor-07-pe2-geometry-index-read-surface",
+  },
+  uxIntent: { uiVisible: false, expectsUxResponse: "none" },
+  agentMetadata: {
+    readOrMutate: "read",
+    boundedScope: "document",
+    auditCategory: "geometry-read",
+  },
+  stateClass: "A-canonical",
+  persistsTo: "canonical",
+  rwdReference:
+    "§Runtime API § runtime.geometry.getGeometryCoverage. PE2 lightweight status read over GeometryFacet.getGeometryCoverage(). Always returns a coverage object; unwired/pre-paint states report status:'unavailable' with zero counts so agents and evidence runners can distinguish no geometry from empty geometry.",
+};
+
 /* ================================================================== */
 /*  getCaret — Slice-4 caret geometry (Slice X3 of §4 of coord-05)    */
 /* ================================================================== */
@@ -224,6 +288,21 @@ export function createGeometryFamily(runtime: RuntimeApiHandle) {
   const geometry = runtime.geometry;
 
   return {
+    getGeometryIndex(): GeometryIndex | null {
+      // @endStateApi — live-with-adapter. Exposes the Layer-05 PE2
+      // geometry index through the v3 runtime seam. The current L05
+      // index is projected from the render frame; callers still get
+      // renderer-neutral value objects and no DOM/PM/runtime instances.
+      return geometry?.getGeometryIndex() ?? null;
+    },
+
+    getGeometryCoverage(): GeometryIndexCoverage {
+      // @endStateApi — live-with-adapter. Coverage is intentionally
+      // total: an unwired/pre-paint handle reports an unavailable zero
+      // summary instead of null so evidence code can branch on status.
+      return geometry?.getGeometryCoverage() ?? createUnavailableGeometryCoverage();
+    },
+
     getBlockRects(blockIds: readonly string[]): ReadonlyArray<BlockRectEntry & Partial<MockPayload>> {
       // @endStateApi — live-with-adapter. Routes directly through the
       // Layer-05 GeometryFacet's `getBlockRects(blockId)`, which walks

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;
 }