@beyondwork/docx-react-component 1.0.28 → 1.0.29

package/dist/core/commands/table-structure-commands.cjs

@@ -0,0 +1,1883 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/commands/table-structure-commands.ts
+var table_structure_commands_exports = {};
+__export(table_structure_commands_exports, {
+  applyTableStructureOperation: () => applyTableStructureOperation
+});
+module.exports = __toCommonJS(table_structure_commands_exports);
+
+// src/core/selection/mapping.ts
+var DEFAULT_BOUNDARY_ASSOC = {
+  start: 1,
+  end: -1
+};
+function createRangeAnchor(from, to = from, assoc = DEFAULT_BOUNDARY_ASSOC) {
+  return {
+    kind: "range",
+    range: normalizeRange({ from, to }),
+    assoc
+  };
+}
+function createNodeAnchor(at, assoc = 1) {
+  return {
+    kind: "node",
+    at,
+    assoc
+  };
+}
+function createDetachedAnchor(lastKnownRange, reason) {
+  return {
+    kind: "detached",
+    lastKnownRange: normalizeRange(lastKnownRange),
+    reason
+  };
+}
+function normalizeRange(range) {
+  return range.from <= range.to ? { from: range.from, to: range.to } : { from: range.to, to: range.from };
+}
+
+// src/core/state/editor-state.ts
+function createSelectionSnapshot(anchor = 0, head = anchor) {
+  return {
+    anchor,
+    head,
+    isCollapsed: anchor === head,
+    activeRange: createRangeAnchor(anchor, head, DEFAULT_BOUNDARY_ASSOC)
+  };
+}
+
+// src/preservation/store.ts
+function getOpaqueFragment(store, fragmentId) {
+  return normalizeOpaqueFragmentMap(store)[fragmentId];
+}
+function describeOpaqueFragment(fragment) {
+  const xml = fragment.payloadReference;
+  const detail = createDetail(fragment);
+  if (/\b(?:w:)?sectPr\b/u.test(xml)) {
+    return {
+      featureKey: "sections",
+      label: "Section properties",
+      detail
+    };
+  }
+  if (/\b(?:w:)?tbl\b/u.test(xml)) {
+    return {
+      featureKey: "tables",
+      label: "Preserved table structure",
+      detail
+    };
+  }
+  if (/\b(?:w:)?hdr\b|\b(?:w:)?ftr\b/u.test(xml)) {
+    return {
+      featureKey: "headers-footers",
+      label: "Header or footer content",
+      detail
+    };
+  }
+  if (/\b(?:w:)?fldSimple\b|\b(?:w:)?fldChar\b|\b(?:w:)?instrText\b/u.test(xml)) {
+    return {
+      featureKey: "fields",
+      label: "Word field content",
+      detail
+    };
+  }
+  if (/\b(?:w:)?sdt\b/u.test(xml)) {
+    return {
+      featureKey: "content-controls",
+      label: "Content control",
+      detail
+    };
+  }
+  if (/\b(?:w:)?customXml\b/u.test(xml)) {
+    return {
+      featureKey: "custom-xml",
+      label: "Custom XML wrapper",
+      detail
+    };
+  }
+  if (/\b(?:w:)?altChunk\b/u.test(xml)) {
+    return {
+      featureKey: "alt-chunk",
+      label: "Alternate content import",
+      detail
+    };
+  }
+  if (/\b(?:w:)?object\b|\b(?:o:)?OLEObject\b/u.test(xml)) {
+    return {
+      featureKey: "embedded-objects",
+      label: "Embedded object",
+      detail
+    };
+  }
+  if (/\b(?:mc:)?AlternateContent\b/u.test(xml)) {
+    return {
+      featureKey: "alternate-content",
+      label: "Markup compatibility block",
+      detail
+    };
+  }
+  return {
+    featureKey: "unknown-ooxml",
+    label: "Unsupported OOXML fragment",
+    detail
+  };
+}
+function createDetail(fragment) {
+  const detail = [
+    `Preserved whole-unit from ${fragment.lastKnownRange.from}-${fragment.lastKnownRange.to}.`,
+    fragment.packagePartName ? `Part ${fragment.packagePartName}.` : null,
+    fragment.relationshipId ? `Relationship ${fragment.relationshipId}.` : null
+  ].filter(Boolean).join(" ");
+  return detail.length > 0 ? detail : "Preserved whole-unit to keep unsupported OOXML intact.";
+}
+function normalizeOpaqueFragmentMap(store) {
+  return store && typeof store === "object" && store.opaqueFragments && typeof store.opaqueFragments === "object" ? store.opaqueFragments : {};
+}
+
+// src/runtime/story-context.ts
+function collectSectionContexts(document) {
+  const sections = [];
+  let sectionIndex = 0;
+  for (const block of document.content.children) {
+    if (block.type !== "section_break") {
+      continue;
+    }
+    sections.push({
+      index: sectionIndex,
+      properties: block.sectionProperties
+    });
+    sectionIndex += 1;
+  }
+  sections.push({
+    index: sectionIndex,
+    properties: document.subParts?.finalSectionProperties
+  });
+  return sections;
+}
+function resolveSectionVariants(kind, sectionIndex, explicitReferences, documents) {
+  if (explicitReferences && explicitReferences.length > 0) {
+    return explicitReferences.map((ref) => ({
+      variant: ref.variant,
+      relationshipId: ref.relationshipId
+    }));
+  }
+  return documents.filter(
+    (entry) => entry.sectionIndex === void 0 || entry.sectionIndex === sectionIndex
+  ).map((entry) => ({
+    variant: entry.variant,
+    relationshipId: entry.relationshipId
+  }));
+}
+function findHeaderFooterDocumentEntry(document, target) {
+  const documents = target.kind === "header" ? document.subParts?.headers ?? [] : document.subParts?.footers ?? [];
+  const matches = documents.filter(
+    (entry) => entry.relationshipId === target.relationshipId && entry.variant === target.variant
+  );
+  if (matches.length === 0) {
+    return void 0;
+  }
+  if (target.sectionIndex !== void 0) {
+    return matches.find((entry) => entry.sectionIndex === target.sectionIndex) ?? matches.find((entry) => entry.sectionIndex === void 0) ?? matches[0];
+  }
+  return matches[0];
+}
+function sectionSupportsStoryTarget(document, sectionIndex, target) {
+  if (!findHeaderFooterDocumentEntry(document, target)) {
+    return false;
+  }
+  const section = collectSectionContexts(document).find(
+    (candidate) => candidate.index === sectionIndex
+  );
+  if (!section) {
+    return false;
+  }
+  const variants = resolveSectionVariants(
+    target.kind,
+    sectionIndex,
+    target.kind === "header" ? section.properties?.headerReferences : section.properties?.footerReferences,
+    target.kind === "header" ? document.subParts?.headers ?? [] : document.subParts?.footers ?? []
+  );
+  return variants.some(
+    (variant) => variant.relationshipId === target.relationshipId && variant.variant === target.variant
+  );
+}
+function normalizeHeaderFooterTarget(document, target, preferredSectionIndex) {
+  if (!findHeaderFooterDocumentEntry(document, target)) {
+    return void 0;
+  }
+  if (target.sectionIndex !== void 0) {
+    return sectionSupportsStoryTarget(document, target.sectionIndex, target) ? target : void 0;
+  }
+  const candidateIndexes = collectSectionContexts(document).map((section) => section.index).filter(
+    (sectionIndex) => sectionSupportsStoryTarget(document, sectionIndex, target)
+  );
+  if (candidateIndexes.length === 0) {
+    return void 0;
+  }
+  const resolvedSectionIndex = preferredSectionIndex !== void 0 && candidateIndexes.includes(preferredSectionIndex) ? preferredSectionIndex : candidateIndexes[0];
+  return {
+    ...target,
+    sectionIndex: resolvedSectionIndex
+  };
+}
+
+// src/runtime/story-targeting.ts
+function getStoryBlocks(document, target) {
+  if (target.kind === "main") {
+    return document.content.children;
+  }
+  const subParts = document.subParts;
+  if (!subParts) {
+    return [];
+  }
+  switch (target.kind) {
+    case "header": {
+      const resolvedTarget = normalizeHeaderFooterTarget(document, target);
+      return (resolvedTarget && findHeaderFooterDocumentEntry(document, resolvedTarget)?.blocks) ?? [];
+    }
+    case "footer": {
+      const resolvedTarget = normalizeHeaderFooterTarget(document, target);
+      return (resolvedTarget && findHeaderFooterDocumentEntry(document, resolvedTarget)?.blocks) ?? [];
+    }
+    case "footnote":
+      return subParts.footnoteCollection?.footnotes[target.noteId]?.blocks ?? [];
+    case "endnote":
+      return subParts.footnoteCollection?.endnotes[target.noteId]?.blocks ?? [];
+  }
+}
+
+// src/runtime/numbering-prefix.ts
+var DEFAULT_START_AT = 1;
+function createNumberingPrefixResolver(catalog) {
+  const sequenceStates = /* @__PURE__ */ new Map();
+  function resolveInternal(numbering) {
+    if (!numbering) {
+      return null;
+    }
+    const instance = catalog.instances[numbering.numberingInstanceId];
+    if (!instance) {
+      return null;
+    }
+    const definition = catalog.abstractDefinitions[instance.abstractNumberingId];
+    if (!definition) {
+      return null;
+    }
+    const levelDefinitions = new Map(
+      definition.levels.map((level) => [level.level, level])
+    );
+    const levelDefinition = levelDefinitions.get(numbering.level);
+    if (!levelDefinition || levelDefinition.format === "none") {
+      return null;
+    }
+    const sequenceState = getSequenceState(sequenceStates, numbering.numberingInstanceId);
+    advanceSequence(sequenceState, numbering.level, levelDefinitions, instance.overrides);
+    const effectiveLevelDefs = levelDefinition.isLegalNumbering ? new Map(Array.from(levelDefinitions.entries()).map(([k, v]) => [k, { ...v, format: "decimal" }])) : levelDefinitions;
+    const text = renderLevelText(levelDefinition.text, sequenceState.counters, effectiveLevelDefs);
+    if (text === null) return null;
+    return { text, suffix: levelDefinition.suffix };
+  }
+  return {
+    resolve(numbering) {
+      const result = resolveInternal(numbering);
+      return result?.text ?? null;
+    },
+    resolveDetailed(numbering) {
+      return resolveInternal(numbering);
+    }
+  };
+}
+function getSequenceState(states, numberingInstanceId) {
+  const existing = states.get(numberingInstanceId);
+  if (existing) {
+    return existing;
+  }
+  const created = {
+    counters: [],
+    lastLevel: null
+  };
+  states.set(numberingInstanceId, created);
+  return created;
+}
+function advanceSequence(state, currentLevel, levelDefinitions, overrides) {
+  if (state.lastLevel !== null && currentLevel <= state.lastLevel) {
+    state.counters.length = currentLevel + 1;
+  }
+  const startAt = getLevelStartAt(currentLevel, levelDefinitions, overrides);
+  const currentValue = state.counters[currentLevel];
+  state.counters[currentLevel] = currentValue === void 0 ? startAt : currentValue + 1;
+  state.lastLevel = currentLevel;
+}
+function getLevelStartAt(level, levelDefinitions, overrides) {
+  const override = overrides.find((entry) => entry.level === level);
+  if (override?.startAt !== void 0) {
+    return override.startAt;
+  }
+  return levelDefinitions.get(level)?.startAt ?? DEFAULT_START_AT;
+}
+function renderLevelText(text, counters, levelDefinitions) {
+  if (!text) {
+    return null;
+  }
+  if (!text.includes("%")) {
+    return text;
+  }
+  const rendered = text.replace(/%([1-9])/g, (_match, token) => {
+    const level = Number.parseInt(token, 10) - 1;
+    const counter = counters[level];
+    if (counter === void 0) {
+      return "";
+    }
+    const format = levelDefinitions.get(level)?.format ?? "decimal";
+    return formatCounter(counter, format);
+  });
+  return rendered.trim().length > 0 ? rendered : null;
+}
+function formatCounter(value, format) {
+  switch (format) {
+    case "decimal":
+      return String(value);
+    case "decimalZero":
+      return String(value).padStart(2, "0");
+    case "upperLetter":
+      return toAlphabetic(value).toUpperCase();
+    case "lowerLetter":
+      return toAlphabetic(value).toLowerCase();
+    case "upperRoman":
+      return toRoman(value).toUpperCase();
+    case "lowerRoman":
+      return toRoman(value).toLowerCase();
+    case "none":
+      return "";
+    default:
+      return String(value);
+  }
+}
+function toAlphabetic(value) {
+  if (value <= 0) {
+    return String(value);
+  }
+  let remainder = value;
+  let result = "";
+  while (remainder > 0) {
+    remainder -= 1;
+    result = String.fromCharCode(65 + remainder % 26) + result;
+    remainder = Math.floor(remainder / 26);
+  }
+  return result;
+}
+function toRoman(value) {
+  if (value <= 0 || value >= 4e3) {
+    return String(value);
+  }
+  const numerals = [
+    [1e3, "M"],
+    [900, "CM"],
+    [500, "D"],
+    [400, "CD"],
+    [100, "C"],
+    [90, "XC"],
+    [50, "L"],
+    [40, "XL"],
+    [10, "X"],
+    [9, "IX"],
+    [5, "V"],
+    [4, "IV"],
+    [1, "I"]
+  ];
+  let remaining = value;
+  let result = "";
+  for (const [amount, numeral] of numerals) {
+    while (remaining >= amount) {
+      remaining -= amount;
+      result += numeral;
+    }
+  }
+  return result;
+}
+
+// src/runtime/surface-projection.ts
+function createEditorSurfaceSnapshot(document, _selection, activeStory = { kind: "main" }) {
+  const root = normalizeDocumentRoot({
+    type: "doc",
+    children: [...getStoryBlocks(document, activeStory)]
+  });
+  const blocks = [];
+  const lockedFragmentIds = [];
+  const numberingPrefixResolver = createNumberingPrefixResolver(document.numbering);
+  let cursor = 0;
+  const counters = {
+    paragraph: 0,
+    table: 0,
+    opaque: 0,
+    sdt: 0,
+    customXml: 0,
+    altChunk: 0
+  };
+  for (let index = 0; index < root.children.length; index += 1) {
+    const surfaceBlock = createSurfaceBlock(
+      root.children[index],
+      document,
+      cursor,
+      counters,
+      numberingPrefixResolver
+    );
+    blocks.push(surfaceBlock.block);
+    lockedFragmentIds.push(...surfaceBlock.lockedFragmentIds);
+    cursor = surfaceBlock.nextCursor;
+    if (index < root.children.length - 1 && root.children[index + 1]?.type === "paragraph") {
+      cursor += 1;
+    }
+  }
+  const secondaryStories = createSecondaryStorySurfaces(document);
+  return {
+    storySize: cursor,
+    plainText: createPlainText(blocks),
+    blocks,
+    lockedFragmentIds,
+    secondaryStories
+  };
+}
+function createSurfaceBlock(block, document, cursor, counters, numberingPrefixResolver) {
+  if (block.type === "opaque_block") {
+    const fragment = getOpaqueFragment(document.preservation, block.fragmentId);
+    const descriptor = fragment ? describeOpaqueFragment(fragment) : null;
+    const blockId = `opaque-${counters.opaque}`;
+    counters.opaque += 1;
+    return {
+      block: {
+        blockId,
+        kind: "opaque_block",
+        from: cursor,
+        to: cursor + 1,
+        fragmentId: block.fragmentId,
+        warningId: block.warningId,
+        label: descriptor?.label ?? "Unsupported OOXML fragment",
+        detail: descriptor?.detail ?? "Locked whole-unit to keep unsupported OOXML intact through export.",
+        state: "locked-preserve-only"
+      },
+      lockedFragmentIds: [block.fragmentId],
+      nextCursor: cursor + 1
+    };
+  }
+  if (block.type === "table") {
+    const tableIndex = counters.table;
+    counters.table += 1;
+    return createTableBlock(
+      tableIndex,
+      block,
+      document,
+      cursor,
+      counters,
+      numberingPrefixResolver
+    );
+  }
+  if (block.type === "sdt") {
+    const sdtIndex = counters.sdt;
+    counters.sdt += 1;
+    return createSdtBlock(
+      sdtIndex,
+      block,
+      document,
+      cursor,
+      counters,
+      numberingPrefixResolver
+    );
+  }
+  if (block.type === "custom_xml") {
+    const blockId = `custom-xml-${counters.customXml}`;
+    counters.customXml += 1;
+    return {
+      block: {
+        blockId,
+        kind: "opaque_block",
+        from: cursor,
+        to: cursor + 1,
+        fragmentId: blockId,
+        warningId: blockId,
+        label: "Custom XML block",
+        detail: block.uri || block.element ? `Custom XML wrapper ${[block.element, block.uri].filter(Boolean).join(" ")} preserved as a read-only block.` : "Custom XML wrapper preserved as a read-only block.",
+        state: "locked-preserve-only"
+      },
+      lockedFragmentIds: [],
+      nextCursor: cursor + 1
+    };
+  }
+  if (block.type === "alt_chunk") {
+    const blockId = `alt-chunk-${counters.altChunk}`;
+    counters.altChunk += 1;
+    return {
+      block: {
+        blockId,
+        kind: "opaque_block",
+        from: cursor,
+        to: cursor + 1,
+        fragmentId: blockId,
+        warningId: blockId,
+        label: "AltChunk import",
+        detail: `Alternate content import remains read-only through relationship ${block.relationshipId}.`,
+        state: "locked-preserve-only"
+      },
+      lockedFragmentIds: [],
+      nextCursor: cursor + 1
+    };
+  }
+  if (block.type === "section_break") {
+    const blockId = `section-break-${counters.opaque}`;
+    counters.opaque += 1;
+    return {
+      block: {
+        blockId,
+        kind: "opaque_block",
+        from: cursor,
+        to: cursor + 1,
+        fragmentId: blockId,
+        warningId: blockId,
+        label: "Section break",
+        detail: "Section properties preserved as a read-only boundary.",
+        state: "locked-preserve-only"
+      },
+      lockedFragmentIds: [],
+      nextCursor: cursor + 1
+    };
+  }
+  const paragraphIndex = counters.paragraph;
+  counters.paragraph += 1;
+  return createParagraphBlock(
+    paragraphIndex,
+    block,
+    document,
+    cursor,
+    numberingPrefixResolver
+  );
+}
+function createTableBlock(tableIndex, table, document, cursor, counters, numberingPrefixResolver) {
+  const lockedFragmentIds = [];
+  let innerCursor = cursor;
+  const rows = [];
+  const rowSpans = computeTableRowSpans(table);
+  for (const [rowIndex, row] of table.rows.entries()) {
+    const cells = [];
+    for (const [cellIndex, cell] of row.cells.entries()) {
+      const cellContent = [];
+      for (const child of cell.children) {
+        const result = createSurfaceBlock(
+          child,
+          document,
+          innerCursor,
+          counters,
+          numberingPrefixResolver
+        );
+        cellContent.push(result.block);
+        lockedFragmentIds.push(...result.lockedFragmentIds);
+        innerCursor = result.nextCursor;
+      }
+      const cellBorders = resolveCellBorderStyles(cell.borders);
+      cells.push({
+        gridSpan: cell.gridSpan ?? 1,
+        verticalMerge: cell.verticalMerge ?? null,
+        colspan: cell.gridSpan ?? 1,
+        rowspan: rowSpans.get(`${rowIndex}:${cellIndex}`) ?? 1,
+        ...cell.shading?.fill ? { backgroundColor: `#${cell.shading.fill}` } : {},
+        ...cell.verticalAlign ? { verticalAlign: cell.verticalAlign } : {},
+        ...cellBorders.borderTop ? { borderTop: cellBorders.borderTop } : {},
+        ...cellBorders.borderRight ? { borderRight: cellBorders.borderRight } : {},
+        ...cellBorders.borderBottom ? { borderBottom: cellBorders.borderBottom } : {},
+        ...cellBorders.borderLeft ? { borderLeft: cellBorders.borderLeft } : {},
+        content: cellContent
+      });
+    }
+    rows.push({
+      cells,
+      ...row.gridBefore !== void 0 ? { gridBefore: row.gridBefore } : {},
+      ...row.gridAfter !== void 0 ? { gridAfter: row.gridAfter } : {},
+      ...row.height !== void 0 ? { height: row.height } : {},
+      ...row.heightRule ? { heightRule: row.heightRule } : {},
+      ...row.isHeader ? { isHeader: row.isHeader } : {}
+    });
+  }
+  return {
+    block: {
+      blockId: `table-${tableIndex}`,
+      kind: "table",
+      from: cursor,
+      to: innerCursor,
+      styleId: table.styleId,
+      gridColumns: table.gridColumns,
+      ...table.alignment ? { alignment: table.alignment } : {},
+      ...table.tblLook ? { tblLook: table.tblLook } : {},
+      rows
+    },
+    lockedFragmentIds,
+    nextCursor: innerCursor
+  };
+}
+function computeTableRowSpans(table) {
+  const positionedRows = table.rows.map((row) => {
+    let startColumn = 0;
+    return row.cells.map((cell, cellIndex) => {
+      const width = cell.gridSpan ?? 1;
+      const positionedCell = {
+        cell,
+        cellIndex,
+        startColumn,
+        endColumn: startColumn + width - 1
+      };
+      startColumn += width;
+      return positionedCell;
+    });
+  });
+  const rowSpans = /* @__PURE__ */ new Map();
+  for (const [rowIndex, row] of positionedRows.entries()) {
+    for (const positionedCell of row) {
+      if (positionedCell.cell.verticalMerge !== "restart") {
+        rowSpans.set(`${rowIndex}:${positionedCell.cellIndex}`, 1);
+        continue;
+      }
+      let rowspan = 1;
+      for (let nextRowIndex = rowIndex + 1; nextRowIndex < positionedRows.length; nextRowIndex += 1) {
+        const continuedCell = positionedRows[nextRowIndex]?.find(
+          (candidate) => candidate.cell.verticalMerge === "continue" && candidate.startColumn === positionedCell.startColumn && candidate.endColumn === positionedCell.endColumn
+        );
+        if (!continuedCell) {
+          break;
+        }
+        rowspan += 1;
+      }
+      rowSpans.set(`${rowIndex}:${positionedCell.cellIndex}`, rowspan);
+    }
+  }
+  return rowSpans;
+}
+function resolveCellBorderStyles(borders) {
+  if (!borders) return {};
+  const result = {};
+  const sides = [["top", "borderTop"], ["right", "borderRight"], ["bottom", "borderBottom"], ["left", "borderLeft"]];
+  for (const [side, key] of sides) {
+    const spec = borders[side];
+    if (!spec || spec.value === "none" || spec.value === "nil") continue;
+    const width = spec.size ? `${Math.max(1, Math.round(spec.size / 8))}px` : "1px";
+    const style = spec.value === "double" ? "double" : spec.value === "dashed" || spec.value === "dashSmallGap" ? "dashed" : spec.value === "dotted" ? "dotted" : "solid";
+    const color = spec.color && spec.color !== "auto" ? `#${spec.color}` : "currentColor";
+    result[key] = `${width} ${style} ${color}`;
+  }
+  return result;
+}
+function createSdtBlock(sdtIndex, block, document, cursor, counters, numberingPrefixResolver) {
+  const children = [];
+  const lockedFragmentIds = [];
+  let innerCursor = cursor;
+  for (const child of block.children) {
+    const result = createSurfaceBlock(
+      child,
+      document,
+      innerCursor,
+      counters,
+      numberingPrefixResolver
+    );
+    children.push(result.block);
+    lockedFragmentIds.push(...result.lockedFragmentIds);
+    innerCursor = result.nextCursor;
+  }
+  return {
+    block: {
+      blockId: `sdt-${sdtIndex}`,
+      kind: "sdt_block",
+      from: cursor,
+      to: innerCursor,
+      ...block.properties.sdtType ? { sdtType: block.properties.sdtType } : {},
+      ...block.properties.alias ? { alias: block.properties.alias } : {},
+      ...block.properties.tag ? { tag: block.properties.tag } : {},
+      ...block.properties.lock ? { lock: block.properties.lock } : {},
+      ...block.properties.checkbox ? { checkboxChecked: block.properties.checkbox.checked } : {},
+      ...block.properties.datePicker?.fullDate ? { dateValue: block.properties.datePicker.fullDate } : {},
+      ...block.properties.dropdownList ? { dropdownItems: block.properties.dropdownList } : {},
+      ...block.properties.comboBox ? { comboBoxItems: block.properties.comboBox } : {},
+      ...block.properties.showingPlcHdr ? { showingPlcHdr: true } : {},
+      children
+    },
+    lockedFragmentIds,
+    nextCursor: innerCursor
+  };
+}
+function createParagraphBlock(paragraphIndex, paragraph, document, start, numberingPrefixResolver) {
+  const accumulator = {
+    blockId: `paragraph-${paragraphIndex}`,
+    kind: "paragraph",
+    from: start,
+    to: start,
+    ...paragraph.styleId ? { styleId: paragraph.styleId } : {},
+    ...paragraph.numbering ? { numbering: paragraph.numbering } : {},
+    ...paragraph.numbering ? (() => {
+      const detailed = numberingPrefixResolver.resolveDetailed(paragraph.numbering);
+      return detailed ? {
+        numberingPrefix: detailed.text,
+        ...detailed.suffix ? { numberingSuffix: detailed.suffix } : {}
+      } : {};
+    })() : {},
+    ...paragraph.alignment ? { alignment: paragraph.alignment } : {},
+    ...paragraph.spacing ? { spacing: paragraph.spacing } : {},
+    ...paragraph.contextualSpacing !== void 0 ? { contextualSpacing: paragraph.contextualSpacing } : {},
+    ...paragraph.indentation ? { indentation: paragraph.indentation } : {},
+    ...paragraph.borders ? { borders: paragraph.borders } : {},
+    ...paragraph.shading ? { shading: paragraph.shading } : {},
+    ...paragraph.tabStops && paragraph.tabStops.length > 0 ? { tabStops: paragraph.tabStops.map((tabStop) => toSurfaceTabStop(tabStop)) } : {},
+    ...paragraph.keepNext ? { keepNext: true } : {},
+    ...paragraph.keepLines ? { keepLines: true } : {},
+    ...paragraph.pageBreakBefore ? { pageBreakBefore: true } : {},
+    ...paragraph.outlineLevel !== void 0 ? { outlineLevel: paragraph.outlineLevel } : {},
+    ...paragraph.bidi ? { bidi: true } : {},
+    ...paragraph.suppressLineNumbers ? { suppressLineNumbers: true } : {},
+    segments: []
+  };
+  const lockedFragmentIds = [];
+  let cursor = start;
+  const children = Array.isArray(paragraph.children) ? paragraph.children : [];
+  for (const child of children) {
+    const result = appendInlineSegments(accumulator, child, document, cursor);
+    cursor = result.nextCursor;
+    lockedFragmentIds.push(...result.lockedFragmentIds);
+  }
+  accumulator.to = cursor;
+  return {
+    block: accumulator,
+    nextCursor: cursor,
+    lockedFragmentIds
+  };
+}
+function appendInlineSegments(paragraph, node, document, start, hyperlinkHref) {
+  switch (node.type) {
+    case "text":
+      paragraph.segments.push({
+        segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+        kind: "text",
+        from: start,
+        to: start + Array.from(node.text).length,
+        text: node.text,
+        ...node.marks ? (() => {
+          const result = cloneMarks(node.marks);
+          return {
+            ...result.marks.length > 0 ? { marks: result.marks } : {},
+            ...result.markAttrs ? { markAttrs: result.markAttrs } : {}
+          };
+        })() : {},
+        ...hyperlinkHref ? { hyperlinkHref } : {}
+      });
+      return { nextCursor: start + Array.from(node.text).length, lockedFragmentIds: [] };
+    case "tab":
+      paragraph.segments.push({
+        segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+        kind: "tab",
+        from: start,
+        to: start + 1,
+        ...hyperlinkHref ? { hyperlinkHref } : {}
+      });
+      return { nextCursor: start + 1, lockedFragmentIds: [] };
+    case "hard_break":
+      paragraph.segments.push({
+        segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+        kind: "hard_break",
+        from: start,
+        to: start + 1,
+        ...hyperlinkHref ? { hyperlinkHref } : {}
+      });
+      return { nextCursor: start + 1, lockedFragmentIds: [] };
+    case "hyperlink": {
+      let cursor = start;
+      for (const child of node.children) {
+        const result = appendInlineSegments(paragraph, child, document, cursor, node.href);
+        cursor = result.nextCursor;
+      }
+      return { nextCursor: cursor, lockedFragmentIds: [] };
+    }
+    case "image":
+      paragraph.segments.push({
+        segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+        kind: "image",
+        from: start,
+        to: start + 1,
+        mediaId: node.mediaId,
+        altText: node.altText,
+        state: hasMediaItem(document.media, node.mediaId) ? "editable" : "missing",
+        ...node.display ? { display: node.display } : {},
+        detail: node.display === "floating" ? createFloatingImageDetail(node.altText, node.floating) : node.altText ? `Alt text ${node.altText}.` : "Inline image remains a whole-unit render surface."
+      });
+      return { nextCursor: start + 1, lockedFragmentIds: [] };
+    case "opaque_inline": {
+      const fragment = getOpaqueFragment(document.preservation, node.fragmentId);
+      const descriptor = fragment ? describeOpaqueFragment(fragment) : null;
+      const preview = fragment ? describePreservedInlinePreview(fragment.payloadReference) : null;
+      paragraph.segments.push({
+        segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+        kind: "opaque_inline",
+        from: start,
+        to: start + 1,
+        fragmentId: node.fragmentId,
+        warningId: node.warningId,
+        label: preview?.label ?? descriptor?.label ?? "Unsupported inline OOXML",
+        detail: preview?.detail ?? descriptor?.detail ?? "Locked whole-unit to keep unsupported inline OOXML intact through export.",
+        ...preview?.presentation ? { presentation: preview.presentation } : {},
+        state: "locked-preserve-only"
+      });
+      return { nextCursor: start + 1, lockedFragmentIds: [node.fragmentId] };
+    }
+    case "chart_preview":
+      return appendComplexPreviewSegment(paragraph, node, start, "Embedded chart", createChartDetail(node));
+    case "smartart_preview":
+      return appendComplexPreviewSegment(paragraph, node, start, "SmartArt diagram", createSmartArtDetail(node));
+    case "shape":
+      return appendComplexPreviewSegment(
+        paragraph,
+        node,
+        start,
+        node.isTextBox ? "Text box" : "Drawing shape",
+        createShapeDetail(node)
+      );
+    case "wordart":
+      return appendComplexPreviewSegment(paragraph, node, start, "WordArt", createWordArtDetail(node));
+    case "vml_shape":
+      return appendComplexPreviewSegment(paragraph, node, start, "Legacy VML drawing", createVmlDetail(node));
+    case "symbol":
+      paragraph.segments.push({
+        segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+        kind: "text",
+        from: start,
+        to: start + 1,
+        text: node.char ? String.fromCodePoint(parseInt(node.char, 16)) : "\uFFFD"
+      });
+      return { nextCursor: start + 1, lockedFragmentIds: [] };
+    case "column_break":
+      paragraph.segments.push({
+        segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+        kind: "opaque_inline",
+        from: start,
+        to: start + 1,
+        fragmentId: "",
+        warningId: "",
+        label: "Column break",
+        detail: "Column break marker preserved for export.",
+        state: "locked-preserve-only"
+      });
+      return { nextCursor: start + 1, lockedFragmentIds: [] };
+    case "footnote_ref":
+      paragraph.segments.push({
+        segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+        kind: "note_ref",
+        from: start,
+        to: start + 1,
+        noteKind: node.noteKind ?? "footnote",
+        noteId: node.noteId ?? "",
+        label: node.noteId ?? "*"
+      });
+      return { nextCursor: start + 1, lockedFragmentIds: [] };
+    case "field": {
+      const isSupportedField = node.fieldFamily === "REF" || node.fieldFamily === "PAGEREF" || node.fieldFamily === "NOTEREF" || node.fieldFamily === "TOC";
+      if (node.children && node.children.length > 0) {
+        let cursor = start;
+        const lockedIds = [];
+        for (const child of node.children) {
+          const result = appendInlineSegments(paragraph, child, document, cursor);
+          cursor = result.nextCursor;
+          lockedIds.push(...result.lockedFragmentIds);
+        }
+        return { nextCursor: cursor, lockedFragmentIds: lockedIds };
+      }
+      if (isSupportedField) {
+        const fieldLabel = node.fieldFamily === "TOC" ? "Table of Contents" : `${node.fieldFamily ?? "Field"}: ${node.fieldTarget ?? node.instruction.trim()}`;
+        paragraph.segments.push({
+          segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+          kind: "field_ref",
+          from: start,
+          to: start + 1,
+          fieldFamily: node.fieldFamily,
+          fieldTarget: node.fieldTarget,
+          instruction: node.instruction,
+          refreshStatus: node.refreshStatus ?? "stale",
+          label: fieldLabel
+        });
+        return { nextCursor: start + 1, lockedFragmentIds: [] };
+      }
+      paragraph.segments.push({
+        segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+        kind: "opaque_inline",
+        from: start,
+        to: start + 1,
+        fragmentId: "",
+        warningId: "",
+        label: "Field",
+        detail: `Preserve-only field: ${node.instruction.trim()}`,
+        state: "locked-preserve-only"
+      });
+      return { nextCursor: start + 1, lockedFragmentIds: [] };
+    }
+    case "bookmark_start":
+    case "bookmark_end":
+      return { nextCursor: start, lockedFragmentIds: [] };
+    default:
+      return { nextCursor: start + 1, lockedFragmentIds: [] };
+  }
+}
+function appendComplexPreviewSegment(paragraph, node, start, label, detail) {
+  paragraph.segments.push({
+    segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+    kind: "opaque_inline",
+    from: start,
+    to: start + 1,
+    fragmentId: `complex:${label.replace(/\s/g, "-").toLowerCase()}:${start}`,
+    warningId: `warning:complex-preview:${start}`,
+    label,
+    detail,
+    state: "locked-preserve-only"
+  });
+  return { nextCursor: start + 1, lockedFragmentIds: [] };
+}
+function createChartDetail(node) {
+  const parts = ["Embedded chart."];
+  if (node.previewMediaId) {
+    parts.push(`Preview available via fallback image (${node.previewMediaId}).`);
+  } else {
+    parts.push("No fallback preview image found; chart data preserved in package.");
+  }
+  parts.push("Edit in Word to modify chart data. Original DrawingML preserved for lossless export.");
+  return parts.join(" ");
+}
+function createSmartArtDetail(node) {
+  const parts = ["SmartArt diagram."];
+  if (node.previewMediaId) {
+    parts.push(`Preview available via fallback image (${node.previewMediaId}).`);
+  } else {
+    parts.push("No fallback preview image found; diagram structure preserved in package.");
+  }
+  parts.push("Edit in Word to modify diagram layout and content. Original DrawingML preserved for lossless export.");
+  return parts.join(" ");
+}
+function createShapeDetail(node) {
+  if (node.isTextBox) {
+    const parts2 = ["Text box."];
+    if (node.text) parts2.push(`Content: "${node.text}".`);
+    parts2.push("Text content is visible; formatting and geometry preserved for export.");
+    return parts2.join(" ");
+  }
+  const parts = ["Drawing shape."];
+  if (node.geometry) parts.push(`Geometry: ${node.geometry}.`);
+  if (node.text) parts.push(`Text content: "${node.text}".`);
+  parts.push("Visual geometry is preview-only. Original DrawingML preserved for export.");
+  return parts.join(" ");
+}
+function createWordArtDetail(node) {
+  const parts = ["WordArt decorative text."];
+  if (node.text) parts.push(`Text: "${node.text}".`);
+  if (node.geometry) parts.push(`Effect: ${node.geometry}.`);
+  parts.push("Text effect is preview-only. Edit in Word for full formatting. Original DrawingML preserved for export.");
+  return parts.join(" ");
+}
+function createVmlDetail(node) {
+  const parts = ["Legacy VML drawing."];
+  if (node.shapeType) parts.push(`Type: ${node.shapeType}.`);
+  if (node.text) parts.push(`Text content: "${node.text}".`);
+  parts.push("VML content is preview-only. Edit in Word for full control. Original VML XML preserved for export.");
+  return parts.join(" ");
+}
+function createPlainText(blocks) {
+  const text = [];
+  for (const block of blocks) {
+    if (block.kind === "opaque_block") {
+      if (block.fragmentId.startsWith("preview:")) {
+        continue;
+      }
+      text.push("\uFFFA");
+      continue;
+    }
+    if (block.kind === "table") {
+      for (const row of block.rows) {
+        for (const cell of row.cells) {
+          text.push(createPlainText(cell.content));
+        }
+      }
+      continue;
+    }
+    if (block.kind === "sdt_block") {
+      text.push(createPlainText(block.children));
+      continue;
+    }
+    for (const segment of block.segments) {
+      switch (segment.kind) {
+        case "text":
+          text.push(segment.text);
+          break;
+        case "tab":
+          text.push("	");
+          break;
+        case "hard_break":
+          text.push("\n");
+          break;
+        case "image":
+          text.push("\uFFFC");
+          break;
+        case "opaque_inline":
+          text.push("\uFFF9");
+          break;
+      }
+    }
+  }
+  return text.join("");
+}
+function createSecondaryStorySurfaces(document) {
+  const surfaces = [];
+  const subParts = document.subParts;
+  if (!subParts) {
+    return surfaces;
+  }
+  const numberingPrefixResolver = createNumberingPrefixResolver(document.numbering);
+  for (const section of collectSectionContexts(document)) {
+    const headerVariants = resolveSectionVariants(
+      "header",
+      section.index,
+      section.properties?.headerReferences,
+      subParts.headers ?? []
+    );
+    for (const headerVariant of headerVariants) {
+      const target = {
+        kind: "header",
+        relationshipId: headerVariant.relationshipId,
+        variant: headerVariant.variant,
+        sectionIndex: section.index
+      };
+      const header = findHeaderFooterDocumentEntry(document, target);
+      if (!header) {
+        continue;
+      }
+      surfaces.push(
+        createStorySurface(
+          target,
+          `Header \xB7 ${headerVariant.variant}`,
+          header.blocks,
+          document,
+          numberingPrefixResolver
+        )
+      );
+    }
+    const footerVariants = resolveSectionVariants(
+      "footer",
+      section.index,
+      section.properties?.footerReferences,
+      subParts.footers ?? []
+    );
+    for (const footerVariant of footerVariants) {
+      const target = {
+        kind: "footer",
+        relationshipId: footerVariant.relationshipId,
+        variant: footerVariant.variant,
+        sectionIndex: section.index
+      };
+      const footer = findHeaderFooterDocumentEntry(document, target);
+      if (!footer) {
+        continue;
+      }
+      surfaces.push(
+        createStorySurface(
+          target,
+          `Footer \xB7 ${footerVariant.variant}`,
+          footer.blocks,
+          document,
+          numberingPrefixResolver
+        )
+      );
+    }
+  }
+  const footnotes = Object.values(subParts.footnoteCollection?.footnotes ?? {}).sort(compareNoteIds);
+  for (const note of footnotes) {
+    const target = { kind: "footnote", noteId: note.noteId };
+    surfaces.push(createStorySurface(target, `Footnote ${note.noteId}`, note.blocks, document, numberingPrefixResolver));
+  }
+  const endnotes = Object.values(subParts.footnoteCollection?.endnotes ?? {}).sort(compareNoteIds);
+  for (const note of endnotes) {
+    const target = { kind: "endnote", noteId: note.noteId };
+    surfaces.push(createStorySurface(target, `Endnote ${note.noteId}`, note.blocks, document, numberingPrefixResolver));
+  }
+  return surfaces;
+}
+function createStorySurface(target, label, blocks, document, numberingPrefixResolver) {
+  const surfaceBlocks = [];
+  let cursor = 0;
+  const counters = {
+    paragraph: 0,
+    table: 0,
+    opaque: 0,
+    sdt: 0,
+    customXml: 0,
+    altChunk: 0
+  };
+  for (let index = 0; index < blocks.length; index += 1) {
+    const surfaceBlock = createSurfaceBlock(
+      blocks[index],
+      document,
+      cursor,
+      counters,
+      numberingPrefixResolver
+    );
+    surfaceBlocks.push(surfaceBlock.block);
+    cursor = surfaceBlock.nextCursor;
+    if (index < blocks.length - 1 && blocks[index + 1]?.type === "paragraph") {
+      cursor += 1;
+    }
+  }
+  return {
+    target,
+    label,
+    storySize: cursor,
+    blocks: surfaceBlocks
+  };
+}
+function compareNoteIds(left, right) {
+  return Number.parseInt(left.noteId, 10) - Number.parseInt(right.noteId, 10);
+}
+function toSurfaceTabStop(tabStop) {
+  return {
+    pos: tabStop.position,
+    ...tabStop.align ? { val: tabStop.align } : {},
+    ...tabStop.leader ? { leader: tabStop.leader } : {}
+  };
+}
+function describePreservedInlinePreview(payloadReference) {
+  if (/\b(?:w:)?proofErr\b/u.test(payloadReference)) {
+    const proofType = /\bw:type="([^"]+)"/u.exec(payloadReference)?.[1];
+    return {
+      label: "Proofing marker",
+      detail: proofType && proofType.trim().length > 0 ? `Word proofing marker (${proofType}) preserved for export safety.` : "Word proofing marker preserved for export safety.",
+      presentation: "quiet-marker"
+    };
+  }
+  if (/\b(?:w:)?lastRenderedPageBreak\b/u.test(payloadReference)) {
+    return {
+      label: "Rendered page break",
+      detail: "Word rendered page-break marker preserved for export safety.",
+      presentation: "quiet-marker"
+    };
+  }
+  if (/\b(?:w:)?permStart\b/u.test(payloadReference)) {
+    const editorGroup = /\bw:edGrp="([^"]+)"/u.exec(payloadReference)?.[1];
+    return {
+      label: "Protected range start",
+      detail: editorGroup && editorGroup.trim().length > 0 ? `Protected range start for ${editorGroup} preserved for export safety.` : "Protected range start preserved for export safety.",
+      presentation: "quiet-marker"
+    };
+  }
+  if (/\b(?:w:)?permEnd\b/u.test(payloadReference)) {
+    return {
+      label: "Protected range end",
+      detail: "Protected range end preserved for export safety.",
+      presentation: "quiet-marker"
+    };
+  }
+  if (/\b(?:w:)?bookmarkStart\b/u.test(payloadReference)) {
+    const name = /\bw:name="([^"]+)"/u.exec(payloadReference)?.[1];
+    return {
+      label: name ? `Bookmark \xB7 ${name}` : "Bookmark",
+      detail: name ? `Bookmark anchor "${name}" is preserved as a read-only inline token for export safety.` : "Bookmark anchor is preserved as a read-only inline token for export safety."
+    };
+  }
+  if (/\b(?:w:)?bookmarkEnd\b/u.test(payloadReference)) {
+    return {
+      label: "Bookmark end",
+      detail: "Bookmark end marker is preserved as a read-only inline token for export safety."
+    };
+  }
+  if (/\b(?:w:)?fldSimple\b|\b(?:w:)?fldChar\b|\b(?:w:)?instrText\b/u.test(payloadReference)) {
+    const simpleInstruction = /\bw:instr="([^"]*)"/u.exec(payloadReference)?.[1];
+    const complexInstruction = [...payloadReference.matchAll(/<(?:\w+:)?instrText\b[^>]*>([\s\S]*?)<\/(?:\w+:)?instrText>/gu)].map((match) => decodeXmlEntities(match[1] ?? "")).join("").trim();
+    const instruction = (simpleInstruction ?? complexInstruction ?? "").trim();
+    const family = /^([A-Z]+)/i.exec(instruction)?.[1]?.toUpperCase();
+    const label = family === "TOC" ? "Table of Contents field" : family ? `${family} field` : "Field";
+    return {
+      label,
+      detail: instruction.length > 0 ? `Read-only field preserved for export safety. Instruction: ${instruction}.` : "Read-only field preserved for export safety."
+    };
+  }
+  return null;
+}
+function decodeXmlEntities(text) {
+  return text.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&");
+}
+function cloneMarks(marks) {
+  const supported = [];
+  const attrs = {};
+  let shadingColor;
+  let highlightColor;
+  for (const mark of marks) {
+    switch (mark.type) {
+      case "bold":
+      case "italic":
+      case "underline":
+      case "strikethrough":
+      case "doubleStrikethrough":
+      case "vanish":
+      case "emboss":
+      case "imprint":
+      case "shadow":
+        supported.push(mark.type);
+        break;
+      case "position":
+        if (mark.val > 0) supported.push("superscript");
+        else if (mark.val < 0) supported.push("subscript");
+        break;
+      case "backgroundColor":
+        shadingColor = mark.color;
+        break;
+      case "highlight":
+        highlightColor = mark.color;
+        break;
+      case "charSpacing":
+        attrs.charSpacing = mark.val;
+        break;
+      case "kerning":
+        attrs.kerning = mark.val;
+        break;
+      case "textFill":
+        attrs.textFill = mark.xml;
+        break;
+      case "fontFamily":
+        attrs.fontFamily = mark.val;
+        break;
+      case "fontSize":
+        attrs.fontSize = mark.val;
+        break;
+      case "textColor":
+        attrs.textColor = mark.color;
+        break;
+      case "smallCaps":
+        supported.push("smallCaps");
+        break;
+      case "allCaps":
+        supported.push("allCaps");
+        break;
+      case "lang":
+        break;
+    }
+  }
+  if (highlightColor || shadingColor) {
+    attrs.backgroundColor = highlightColor ?? shadingColor;
+  }
+  const hasAttrs = Object.keys(attrs).length > 0;
+  return hasAttrs ? { marks: supported, markAttrs: attrs } : { marks: supported };
+}
+function normalizeDocumentRoot(content) {
+  if (content && typeof content === "object" && (content.type === "doc" || content.type === "document_root")) {
+    return content;
+  }
+  if (Array.isArray(content)) {
+    return {
+      type: "doc",
+      children: content.filter(
+        (value) => Boolean(value) && typeof value === "object" && (value.type === "paragraph" || value.type === "table" || value.type === "sdt" || value.type === "custom_xml" || value.type === "alt_chunk" || value.type === "opaque_block")
+      )
+    };
+  }
+  return {
+    type: "doc",
+    children: [{ type: "paragraph", children: [] }]
+  };
+}
+function createFloatingImageDetail(altText, floating) {
+  const parts = [altText ? `Alt text ${altText}.` : "Floating image rendered inline in the editor."];
+  if (floating?.wrap) {
+    parts.push(`Wrap ${floating.wrap}.`);
+  }
+  if (floating?.horizontalPosition?.align || floating?.horizontalPosition?.offset !== void 0) {
+    parts.push(
+      `Horizontal ${floating.horizontalPosition.align ?? floating.horizontalPosition.offset}.`
+    );
+  }
+  if (floating?.verticalPosition?.align || floating?.verticalPosition?.offset !== void 0) {
+    parts.push(
+      `Vertical ${floating.verticalPosition.align ?? floating.verticalPosition.offset}.`
+    );
+  }
+  return parts.join(" ");
+}
+function hasMediaItem(media, mediaId) {
+  return mediaId in media.items;
+}
+
+// src/core/commands/structural-helpers.ts
+function createNoopStructuralMutation(document, selection) {
+  return {
+    changed: false,
+    document,
+    selection
+  };
+}
+function createEmptyParagraph() {
+  return {
+    type: "paragraph",
+    children: []
+  };
+}
+function findTableCellParagraphSelection(document, tableBlockIndex, rowIndex, cellIndex) {
+  const surface = createEditorSurfaceSnapshot(document, createSelectionSnapshot(0, 0));
+  const tableBlock = surface.blocks[tableBlockIndex];
+  if (!tableBlock || tableBlock.kind !== "table") {
+    return null;
+  }
+  const paragraph = tableBlock.rows[rowIndex]?.cells[cellIndex]?.content.find(
+    (block) => block.kind === "paragraph"
+  );
+  if (!paragraph || paragraph.kind !== "paragraph") {
+    return null;
+  }
+  return createSelectionSnapshot(paragraph.from, paragraph.from);
+}
+function findTopLevelParagraphSelectionNearBlock(document, preferredBlockIndex) {
+  const surface = createEditorSurfaceSnapshot(document, createSelectionSnapshot(0, 0));
+  for (let index = preferredBlockIndex; index < surface.blocks.length; index += 1) {
+    const block = surface.blocks[index];
+    if (block?.kind === "paragraph") {
+      return createSelectionSnapshot(block.from, block.from);
+    }
+  }
+  for (let index = Math.min(preferredBlockIndex - 1, surface.blocks.length - 1); index >= 0; index -= 1) {
+    const block = surface.blocks[index];
+    if (block?.kind === "paragraph") {
+      return createSelectionSnapshot(block.from, block.from);
+    }
+  }
+  return null;
+}
+
+// src/core/commands/table-structure-commands.ts
+function applyTableStructureOperation(document, snapshot, selectionDescriptor, operation) {
+  const root = document.content;
+  const fallbackSelection = toInternalSelectionSnapshot(snapshot.selection);
+  if (!root || root.type !== "doc") {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const effectiveSelection = selectionDescriptor ?? resolveTableSelectionFromSnapshot(snapshot);
+  if (!effectiveSelection) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const target = root.children[effectiveSelection.tableBlockIndex];
+  if (!target || target.type !== "table") {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  switch (operation.type) {
+    case "delete-table":
+      return deleteTableBlock(document, root, effectiveSelection.tableBlockIndex, fallbackSelection);
+    case "set-cell-background":
+      return setCellBackground(document, root, target, effectiveSelection, operation.color, fallbackSelection);
+    case "split-cell":
+      return splitSelectedCell(document, root, target, effectiveSelection, fallbackSelection);
+    case "merge-cells":
+      return mergeSelectedCells(document, root, target, effectiveSelection, fallbackSelection);
+    case "add-row-before":
+      return addRow(document, root, target, effectiveSelection, "before", fallbackSelection);
+    case "add-row-after":
+      return addRow(document, root, target, effectiveSelection, "after", fallbackSelection);
+    case "delete-row":
+      return deleteRow(document, root, target, effectiveSelection, fallbackSelection);
+    case "add-column-before":
+      return addColumn(document, root, target, effectiveSelection, "before", fallbackSelection);
+    case "add-column-after":
+      return addColumn(document, root, target, effectiveSelection, "after", fallbackSelection);
+    case "delete-column":
+      return deleteColumn(document, root, target, effectiveSelection, fallbackSelection);
+    default:
+      return createNoopStructuralMutation(document, fallbackSelection);
+  }
+}
+function addRow(document, root, table, selection, position, fallbackSelection) {
+  if (!isSimpleTable(table)) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const columnCount = getLogicalColumnCount(table);
+  const insertIndex = position === "before" ? selection.anchorCell.rowIndex : selection.anchorCell.rowIndex + 1;
+  const nextRow = {
+    type: "table_row",
+    cells: Array.from({ length: columnCount }, () => createEmptyCell())
+  };
+  const nextTable = {
+    ...table,
+    rows: [
+      ...table.rows.slice(0, insertIndex),
+      nextRow,
+      ...table.rows.slice(insertIndex)
+    ]
+  };
+  return commitTableChange(
+    document,
+    root,
+    selection.tableBlockIndex,
+    nextTable,
+    fallbackSelection,
+    insertIndex,
+    selection.anchorCell.columnIndex
+  );
+}
+function deleteRow(document, root, table, selection, fallbackSelection) {
+  if (!isSimpleTable(table) || table.rows.length <= 1) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const deleteIndex = selection.anchorCell.rowIndex;
+  const nextRows = table.rows.filter((_, rowIndex) => rowIndex !== deleteIndex);
+  const focusRowIndex = Math.max(0, Math.min(deleteIndex, nextRows.length - 1));
+  const nextTable = {
+    ...table,
+    rows: nextRows
+  };
+  return commitTableChange(
+    document,
+    root,
+    selection.tableBlockIndex,
+    nextTable,
+    fallbackSelection,
+    focusRowIndex,
+    selection.anchorCell.columnIndex
+  );
+}
+function addColumn(document, root, table, selection, position, fallbackSelection) {
+  if (!isSimpleTable(table)) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const insertIndex = position === "before" ? selection.anchorCell.columnIndex : selection.anchorCell.columnIndex + 1;
+  const nextTable = {
+    ...table,
+    gridColumns: insertGridColumn(table.gridColumns, insertIndex),
+    rows: table.rows.map((row) => ({
+      ...row,
+      cells: [
+        ...row.cells.slice(0, insertIndex),
+        createEmptyCell(),
+        ...row.cells.slice(insertIndex)
+      ]
+    }))
+  };
+  return commitTableChange(
+    document,
+    root,
+    selection.tableBlockIndex,
+    nextTable,
+    fallbackSelection,
+    selection.anchorCell.rowIndex,
+    insertIndex
+  );
+}
+function deleteColumn(document, root, table, selection, fallbackSelection) {
+  if (!isSimpleTable(table) || getLogicalColumnCount(table) <= 1) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const deleteIndex = selection.anchorCell.columnIndex;
+  const nextTable = {
+    ...table,
+    gridColumns: deleteGridColumn(table.gridColumns, deleteIndex),
+    rows: table.rows.map((row) => ({
+      ...row,
+      cells: row.cells.filter((_, cellIndex) => cellIndex !== deleteIndex)
+    }))
+  };
+  const focusColumnIndex = Math.max(0, Math.min(deleteIndex, getLogicalColumnCount(nextTable) - 1));
+  return commitTableChange(
+    document,
+    root,
+    selection.tableBlockIndex,
+    nextTable,
+    fallbackSelection,
+    selection.anchorCell.rowIndex,
+    focusColumnIndex
+  );
+}
+function mergeSelectedCells(document, root, table, selection, fallbackSelection) {
+  if (!isSimpleTable(table) || selection.selectionKind !== "cell" || selection.rect.bottom - selection.rect.top < 1 || selection.rect.right - selection.rect.left < 1) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const height = selection.rect.bottom - selection.rect.top;
+  const width = selection.rect.right - selection.rect.left;
+  if (height === 1 && width === 1) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const nextRows = table.rows.map((row) => ({
+    ...row,
+    cells: row.cells.map((cell) => cloneCell(cell))
+  }));
+  const mergedChildren = [];
+  for (let rowIndex = selection.rect.top; rowIndex < selection.rect.bottom; rowIndex += 1) {
+    const row = nextRows[rowIndex];
+    if (!row) {
+      return createNoopStructuralMutation(document, fallbackSelection);
+    }
+    for (let columnIndex = selection.rect.left; columnIndex < selection.rect.right; columnIndex += 1) {
+      const cellRef = findCellAtColumn(row, columnIndex);
+      if (!cellRef) {
+        return createNoopStructuralMutation(document, fallbackSelection);
+      }
+      const paragraphs = cellRef.cell.children.filter(
+        (child) => child.type === "paragraph"
+      );
+      mergedChildren.push(...paragraphs.map((paragraph) => structuredClone(paragraph)));
+    }
+  }
+  const topRow = nextRows[selection.rect.top];
+  if (!topRow) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const topLeftRef = findCellAtColumn(topRow, selection.rect.left);
+  if (!topLeftRef) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  topRow.cells[topLeftRef.cellIndex] = {
+    ...topLeftRef.cell,
+    ...width > 1 ? { gridSpan: width } : {},
+    ...height > 1 ? { verticalMerge: "restart" } : {},
+    children: mergedChildren.length > 0 ? mergedChildren : [createEmptyParagraph()]
+  };
+  topRow.cells.splice(topLeftRef.cellIndex + 1, width - 1);
+  for (let rowIndex = selection.rect.top + 1; rowIndex < selection.rect.bottom; rowIndex += 1) {
+    const row = nextRows[rowIndex];
+    const leftRef = findCellAtColumn(row, selection.rect.left);
+    if (!leftRef) {
+      return createNoopStructuralMutation(document, fallbackSelection);
+    }
+    row.cells.splice(
+      leftRef.cellIndex,
+      width,
+      {
+        ...createEmptyCell(),
+        ...width > 1 ? { gridSpan: width } : {},
+        verticalMerge: "continue"
+      }
+    );
+  }
+  const nextTable = {
+    ...table,
+    rows: nextRows
+  };
+  return commitTableChange(
+    document,
+    root,
+    selection.tableBlockIndex,
+    nextTable,
+    fallbackSelection,
+    selection.rect.top,
+    selection.rect.left
+  );
+}
+function splitSelectedCell(document, root, table, selection, fallbackSelection) {
+  const row = table.rows[selection.anchorCell.rowIndex];
+  if (!row) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const cellRef = findCellAtColumn(row, selection.anchorCell.columnIndex);
+  if (!cellRef) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const width = Math.max(1, cellRef.cell.gridSpan ?? 1);
+  const height = Math.max(
+    1,
+    computeRowSpan(table, selection.anchorCell.rowIndex, selection.anchorCell.columnIndex, width)
+  );
+  if (width === 1 && height === 1) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const nextRows = table.rows.map((currentRow) => ({
+    ...currentRow,
+    cells: currentRow.cells.map((cell) => cloneCell(cell))
+  }));
+  const topRow = nextRows[selection.anchorCell.rowIndex];
+  topRow.cells.splice(
+    cellRef.cellIndex,
+    1,
+    stripCellSpan(cellRef.cell),
+    ...Array.from({ length: width - 1 }, () => createEmptyCell())
+  );
+  for (let rowOffset = 1; rowOffset < height; rowOffset += 1) {
+    const rowIndex = selection.anchorCell.rowIndex + rowOffset;
+    const currentRow = nextRows[rowIndex];
+    if (!currentRow) {
+      break;
+    }
+    const continueRef = findCellAtColumn(currentRow, selection.anchorCell.columnIndex);
+    if (!continueRef) {
+      return createNoopStructuralMutation(document, fallbackSelection);
+    }
+    currentRow.cells.splice(
+      continueRef.cellIndex,
+      1,
+      ...Array.from({ length: width }, () => createEmptyCell())
+    );
+  }
+  const nextTable = {
+    ...table,
+    rows: nextRows
+  };
+  return commitTableChange(
+    document,
+    root,
+    selection.tableBlockIndex,
+    nextTable,
+    fallbackSelection,
+    selection.anchorCell.rowIndex,
+    selection.anchorCell.columnIndex
+  );
+}
+function setCellBackground(document, root, table, selection, color, fallbackSelection) {
+  const normalized = normalizeFillColor(color);
+  if (!normalized) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const targetRect = selection.selectionKind === "text" ? {
+    top: 0,
+    left: 0,
+    bottom: table.rows.length,
+    right: getLogicalColumnCount(table)
+  } : selection.rect;
+  let changed = false;
+  const nextRows = table.rows.map((row, rowIndex) => {
+    if (rowIndex < targetRect.top || rowIndex >= targetRect.bottom) {
+      return row;
+    }
+    let cursor = 0;
+    const cells = row.cells.map((cell) => {
+      const start = cursor;
+      const width = cell.gridSpan ?? 1;
+      const end = start + width;
+      cursor = end;
+      if (end <= targetRect.left || start >= targetRect.right) {
+        return cell;
+      }
+      changed = true;
+      return {
+        ...cell,
+        shading: {
+          ...cell.shading ?? {},
+          fill: normalized
+        }
+      };
+    });
+    return {
+      ...row,
+      cells
+    };
+  });
+  if (!changed) {
+    return createNoopStructuralMutation(document, fallbackSelection);
+  }
+  const nextTable = {
+    ...table,
+    rows: nextRows
+  };
+  return commitTableChange(
+    document,
+    root,
+    selection.tableBlockIndex,
+    nextTable,
+    fallbackSelection,
+    selection.anchorCell.rowIndex,
+    selection.anchorCell.columnIndex
+  );
+}
+function deleteTableBlock(document, root, tableBlockIndex, fallbackSelection) {
+  const nextChildren = root.children.filter((_, index) => index !== tableBlockIndex);
+  if (nextChildren.length === 0) {
+    nextChildren.push(createEmptyParagraph());
+  }
+  const nextDocument = {
+    ...document,
+    content: {
+      ...root,
+      children: nextChildren
+    }
+  };
+  const nextSelection = findTopLevelParagraphSelectionNearBlock(nextDocument, tableBlockIndex) ?? fallbackSelection;
+  return {
+    changed: true,
+    document: nextDocument,
+    selection: nextSelection
+  };
+}
+function commitTableChange(document, root, tableBlockIndex, nextTable, fallbackSelection, focusRowIndex, focusColumnIndex) {
+  const nextDocument = {
+    ...document,
+    content: {
+      ...root,
+      children: root.children.map(
+        (child, index) => index === tableBlockIndex ? nextTable : child
+      )
+    }
+  };
+  const nextSelection = findTableCellParagraphSelection(
+    nextDocument,
+    tableBlockIndex,
+    focusRowIndex,
+    focusColumnIndex
+  ) ?? fallbackSelection;
+  return {
+    changed: true,
+    document: nextDocument,
+    selection: nextSelection
+  };
+}
+function resolveTableSelectionFromSnapshot(snapshot) {
+  const selectionFrom = Math.min(snapshot.selection.anchor, snapshot.selection.head);
+  const selectionTo = Math.max(snapshot.selection.anchor, snapshot.selection.head);
+  const surface = snapshot.surface;
+  if (!surface) {
+    return null;
+  }
+  for (let tableBlockIndex = 0; tableBlockIndex < surface.blocks.length; tableBlockIndex += 1) {
+    const block = surface.blocks[tableBlockIndex];
+    if (block.kind !== "table") {
+      continue;
+    }
+    for (let rowIndex = 0; rowIndex < block.rows.length; rowIndex += 1) {
+      const row = block.rows[rowIndex];
+      for (let cellIndex = 0; cellIndex < row.cells.length; cellIndex += 1) {
+        const cell = row.cells[cellIndex];
+        const hit = cell.content.find(
+          (child) => child.kind === "paragraph" && selectionFrom >= child.from && selectionTo <= child.to
+        );
+        if (!hit) {
+          continue;
+        }
+        let logicalColumn = 0;
+        for (let currentIndex = 0; currentIndex < cellIndex; currentIndex += 1) {
+          logicalColumn += row.cells[currentIndex]?.gridSpan ?? 1;
+        }
+        return {
+          tableBlockIndex,
+          selectionKind: "text",
+          anchorCell: {
+            rowIndex,
+            columnIndex: logicalColumn
+          },
+          headCell: {
+            rowIndex,
+            columnIndex: logicalColumn
+          },
+          rect: {
+            top: rowIndex,
+            left: logicalColumn,
+            bottom: rowIndex + 1,
+            right: logicalColumn + (cell.gridSpan ?? 1)
+          }
+        };
+      }
+    }
+  }
+  return null;
+}
+function toInternalSelectionSnapshot(selection) {
+  return {
+    anchor: selection.anchor,
+    head: selection.head,
+    isCollapsed: selection.isCollapsed,
+    activeRange: selection.activeRange.kind === "range" ? createRangeAnchor(
+      selection.activeRange.from,
+      selection.activeRange.to,
+      selection.activeRange.assoc
+    ) : selection.activeRange.kind === "node" ? createNodeAnchor(selection.activeRange.at, selection.activeRange.assoc) : createDetachedAnchor(
+      selection.activeRange.lastKnownRange,
+      selection.activeRange.reason
+    )
+  };
+}
+function isSimpleTable(table) {
+  const width = getLogicalColumnCount(table);
+  return table.rows.every((row) => {
+    let rowWidth = 0;
+    for (const cell of row.cells) {
+      if ((cell.gridSpan ?? 1) !== 1 || cell.verticalMerge) {
+        return false;
+      }
+      rowWidth += 1;
+    }
+    return rowWidth === width;
+  });
+}
+function getLogicalColumnCount(table) {
+  if (table.gridColumns.length > 0) {
+    return table.gridColumns.length;
+  }
+  return table.rows.reduce((max, row) => {
+    const width = row.cells.reduce((sum, cell) => sum + (cell.gridSpan ?? 1), 0);
+    return Math.max(max, width);
+  }, 0);
+}
+function computeRowSpan(table, rowIndex, columnIndex, width) {
+  let rowspan = 1;
+  for (let currentRowIndex = rowIndex + 1; currentRowIndex < table.rows.length; currentRowIndex += 1) {
+    const cellRef = findCellAtColumn(table.rows[currentRowIndex], columnIndex);
+    if (!cellRef || cellRef.cell.verticalMerge !== "continue" || (cellRef.cell.gridSpan ?? 1) !== width) {
+      break;
+    }
+    rowspan += 1;
+  }
+  return rowspan;
+}
+function findCellAtColumn(row, logicalColumnIndex) {
+  let cursor = 0;
+  for (let cellIndex = 0; cellIndex < row.cells.length; cellIndex += 1) {
+    const cell = row.cells[cellIndex];
+    const width = cell.gridSpan ?? 1;
+    if (logicalColumnIndex >= cursor && logicalColumnIndex < cursor + width) {
+      return {
+        cellIndex,
+        cell
+      };
+    }
+    cursor += width;
+  }
+  return null;
+}
+function createEmptyCell() {
+  return {
+    type: "table_cell",
+    children: [createEmptyParagraph()]
+  };
+}
+function cloneCell(cell) {
+  return structuredClone(cell);
+}
+function stripCellSpan(cell) {
+  return {
+    ...cell,
+    gridSpan: void 0,
+    verticalMerge: void 0
+  };
+}
+function insertGridColumn(columns, index) {
+  if (columns.length === 0) {
+    return columns;
+  }
+  const current = columns[index] ?? columns[index - 1] ?? columns[columns.length - 1] ?? 2400;
+  return [...columns.slice(0, index), current, ...columns.slice(index)];
+}
+function deleteGridColumn(columns, index) {
+  if (columns.length <= 1) {
+    return columns;
+  }
+  return columns.filter((_, columnIndex) => columnIndex !== index);
+}
+function normalizeFillColor(color) {
+  const normalized = color.trim().replace(/^#/, "");
+  return /^[0-9A-Fa-f]{3,8}$/.test(normalized) ? normalized.toUpperCase() : null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyTableStructureOperation
+});
+//# sourceMappingURL=table-structure-commands.cjs.map