@beyondwork/docx-react-component 1.0.28 → 1.0.29

package/dist/chunk-EILUG3VB.js

@@ -0,0 +1,1275 @@
+import {
+  describeOpaqueFragment,
+  getOpaqueFragment
+} from "./chunk-SWKWQZXM.js";
+
+// 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 storyTargetKey(target) {
+  switch (target.kind) {
+    case "main":
+      return "main";
+    case "header":
+      return `header:${target.relationshipId}:${target.variant}:${target.sectionIndex ?? "*"}`;
+    case "footer":
+      return `footer:${target.relationshipId}:${target.variant}:${target.sectionIndex ?? "*"}`;
+    case "footnote":
+      return `footnote:${target.noteId}`;
+    case "endnote":
+      return `endnote:${target.noteId}`;
+  }
+}
+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 ?? [];
+  }
+}
+function replaceStoryBlocks(document, target, blocks) {
+  if (target.kind === "main") {
+    return {
+      ...document,
+      content: {
+        ...document.content,
+        children: [...blocks]
+      }
+    };
+  }
+  if (!document.subParts) {
+    return document;
+  }
+  switch (target.kind) {
+    case "header": {
+      const resolvedTarget = normalizeHeaderFooterTarget(document, target);
+      const matchedEntry = resolvedTarget ? findHeaderFooterDocumentEntry(document, resolvedTarget) : void 0;
+      if (!matchedEntry) {
+        return document;
+      }
+      return {
+        ...document,
+        subParts: {
+          ...document.subParts,
+          headers: document.subParts.headers.map(
+            (header) => header.relationshipId === matchedEntry.relationshipId && header.variant === matchedEntry.variant && header.partPath === matchedEntry.partPath ? { ...header, blocks: [...blocks] } : header
+          )
+        }
+      };
+    }
+    case "footer": {
+      const resolvedTarget = normalizeHeaderFooterTarget(document, target);
+      const matchedEntry = resolvedTarget ? findHeaderFooterDocumentEntry(document, resolvedTarget) : void 0;
+      if (!matchedEntry) {
+        return document;
+      }
+      return {
+        ...document,
+        subParts: {
+          ...document.subParts,
+          footers: document.subParts.footers.map(
+            (footer) => footer.relationshipId === matchedEntry.relationshipId && footer.variant === matchedEntry.variant && footer.partPath === matchedEntry.partPath ? { ...footer, blocks: [...blocks] } : footer
+          )
+        }
+      };
+    }
+    case "footnote":
+      return !document.subParts.footnoteCollection?.footnotes[target.noteId] ? document : {
+        ...document,
+        subParts: {
+          ...document.subParts,
+          footnoteCollection: {
+            ...document.subParts.footnoteCollection,
+            footnotes: {
+              ...document.subParts.footnoteCollection.footnotes,
+              [target.noteId]: {
+                ...document.subParts.footnoteCollection.footnotes[target.noteId],
+                blocks: [...blocks]
+              }
+            }
+          }
+        }
+      };
+    case "endnote":
+      return !document.subParts.footnoteCollection?.endnotes[target.noteId] ? document : {
+        ...document,
+        subParts: {
+          ...document.subParts,
+          footnoteCollection: {
+            ...document.subParts.footnoteCollection,
+            endnotes: {
+              ...document.subParts.footnoteCollection.endnotes,
+              [target.noteId]: {
+                ...document.subParts.footnoteCollection.endnotes[target.noteId],
+                blocks: [...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;
+}
+
+export {
+  resolveSectionVariants,
+  sectionSupportsStoryTarget,
+  normalizeHeaderFooterTarget,
+  storyTargetKey,
+  getStoryBlocks,
+  replaceStoryBlocks,
+  createEditorSurfaceSnapshot
+};
+//# sourceMappingURL=chunk-EILUG3VB.js.map