@beyondwork/docx-react-component 1.0.29 → 1.0.30

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

@@ -1,1883 +0,0 @@
-"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