@superdoc/mcp 1.7.0-next.12 → 1.7.0-next.14

package/dist/index.js

@@ -31600,7 +31600,7 @@ var init_host = __esm(() => {
 });
 
 // ../../packages/sdk/langs/node/src/runtime/sdk-version.generated.ts
-var SDK_VERSION = "2.20.0-next.12";
+var SDK_VERSION = "2.20.0-next.14";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { accessSync, chmodSync, constants, existsSync, statSync } from "node:fs";
@@ -202834,6 +202834,18 @@ function commitTracked(input, view) {
     newText: op.newText,
     allocateWIdBlock: allocateLocalizedWIdBlock
   }, inlineContext, namespaceBindings);
+  const refinementStart = compileOp.on.coordinateSpace === "tracked" ? projectTrackedParagraphOffsetToVisible(paragraphXml, compileOp.on.startOffset) : compileOp.on.startOffset;
+  const refinementEnd = compileOp.on.coordinateSpace === "tracked" ? projectTrackedParagraphOffsetToVisible(paragraphXml, compileOp.on.endOffset) : compileOp.on.endOffset;
+  const ownLinkedRefinement = refinementStart !== null && refinementEnd !== null ? refineOwnLinkedInsertion(inlineModel, refinementStart, refinementEnd, op.newText, stamping.author, state) : null;
+  if (ownLinkedRefinement) {
+    localized = {
+      ok: true,
+      bytes: TE17.encode(ownLinkedRefinement.xml),
+      emittedBothSides: false,
+      foldedInsRsid: ownLinkedRefinement.rsid,
+      requiresCollaborationSessionSync: true
+    };
+  }
   const canSpanningDelete = compileOp.on.coordinateSpace !== "tracked" && op.newText.length === 0 && compileOp.on.startOffset < compileOp.on.endOffset;
   const spanningDeleteWIds = [];
   let usedSpanningDelete = false;
@@ -202971,6 +202983,17 @@ function commitTracked(input, view) {
     },
     primaryBytes: localized.bytes,
     rewrite: (paragraphBytes2, paragraphWindow) => {
+      if (ownLinkedRefinement) {
+        const counterpartXml = TD42.decode(paragraphBytes2.subarray(paragraphWindow.byteStart, paragraphWindow.byteEnd));
+        const refinement = refineOwnLinkedInsertion(parseParagraphInlineMap(counterpartXml, namespaceBindings), refinementStart, refinementEnd, op.newText, stamping.author, state);
+        return refinement ? {
+          ok: true,
+          bytes: TE17.encode(refinement.xml),
+          emittedBothSides: false,
+          foldedInsRsid: refinement.rsid,
+          requiresCollaborationSessionSync: true
+        } : { ok: false, reason: "textbox-counterpart-ambiguous" };
+      }
       let additionalWIdIndex = 0;
       const base2 = rewriteLocalizedTracked(paragraphBytes2, paragraphWindow, compileOp, {
         rsid: op.rsid,
@@ -206222,6 +206245,80 @@ function containsOnlyTrackedWrappersAndZeroWidth(xml) {
     return false;
   return containsOnlyZeroWidthParagraphTail(withoutWrappers);
 }
+function refineOwnLinkedInsertion(model, start, end, newText, author, state) {
+  if (newText.includes("\t"))
+    return null;
+  const wrapper = model.pieces.find((piece) => piece.kind === "tracked" && piece.trackedKind === "ins" && piece.visibleStart <= start && piece.visibleEnd >= end);
+  if (!wrapper || wrapper.kind !== "tracked" || !wrapper.children.some((piece) => piece.kind === "container" && piece.containerKind === "complexField") || !wrapper.rsid || !collectSessionCreatedTrackedChangeRsids(state).has(wrapper.rsid) || wrapper.revisionId === null || !collectSessionCreatedTrackedChangeWIds(state).has(Number(wrapper.revisionId)) || classifyInsertionAuthoringOwnership(buildReviewIdentity(author), buildReviewIdentity({
+    name: wrapper.author,
+    email: wrapper.email,
+    initials: wrapper.initials
+  })) !== "same-user")
+    return null;
+  const fields = [];
+  const texts = [];
+  for (const child of wrapper.children) {
+    if (child.kind === "text" && child.textRole === "visible")
+      texts.push(child);
+    else if (child.kind === "container" && child.containerKind === "complexField" && child.resultCharStart !== undefined) {
+      const instructions = child.children.filter((piece) => piece.kind === "text" && piece.textRole === "instruction");
+      if (!/^HYPERLINK\s/i.test(instructions.map((piece) => piece.kind === "text" ? piece.decodedText : "").join("").trim()))
+        return null;
+      for (const piece of child.children) {
+        if (piece.kind === "text") {
+          if (piece.textRole === "visible")
+            texts.push(piece);
+          else if (piece.textRole !== "instruction")
+            return null;
+        } else if (piece.kind !== "marker" || piece.role !== "field")
+          return null;
+      }
+      fields.push(child);
+    } else
+      return null;
+  }
+  if (!fields.length)
+    return null;
+  const paragraphXml = model.paragraphXml;
+  if (start === wrapper.visibleStart && end === wrapper.visibleEnd && newText === "") {
+    return { xml: paragraphXml.slice(0, wrapper.charStart) + paragraphXml.slice(wrapper.charEnd), rsid: wrapper.rsid };
+  }
+  const selected = start === end ? texts.filter((piece) => piece.visibleStart <= start && piece.visibleEnd >= start) : texts.filter((piece) => piece.visibleStart < end && piece.visibleEnd > start);
+  const fieldFor = (piece) => fields.find((field2) => piece.charStart >= field2.resultCharStart && piece.charEnd <= field2.resultCharEnd);
+  if (start === end) {
+    const ordinary = selected.find((piece) => !fieldFor(piece));
+    const interior = selected.find((piece) => piece.visibleStart < start && piece.visibleEnd > start);
+    const chosen = ordinary ?? interior;
+    if (!chosen)
+      return null;
+    selected.splice(0, selected.length, chosen);
+  }
+  const first = selected[0];
+  const last = selected.at(-1);
+  if (!first || !last || first.visibleStart > start || last.visibleEnd < end)
+    return null;
+  const field = fieldFor(first);
+  if (selected.some((piece) => fieldFor(piece) !== field))
+    return null;
+  const patches = [];
+  for (const [index, piece] of selected.entries()) {
+    const tag = /^<([\w.-]+):t\b([^>]*)>[\s\S]*?<\/\1:t>$/.exec(piece.rawXml);
+    if (!tag)
+      return null;
+    const localStart = Math.max(0, start - piece.visibleStart);
+    const localEnd = Math.min(piece.decodedText.length, end - piece.visibleStart);
+    const text = piece.decodedText.slice(0, localStart) + (index === 0 ? newText : "") + piece.decodedText.slice(localEnd);
+    patches.push({
+      start: piece.charStart,
+      end: piece.charEnd,
+      xml: `<${tag[1]}:t${preserveTextElementAttributes(tag[2], text)}>${escapeXmlText(text)}</${tag[1]}:t>`
+    });
+  }
+  let rewritten = paragraphXml;
+  for (const patch of patches.reverse())
+    rewritten = rewritten.slice(0, patch.start) + patch.xml + rewritten.slice(patch.end);
+  return { xml: rewritten, rsid: wrapper.rsid };
+}
 function spliceWithinSameAuthorInsertion(paragraphXml, startOffset, endOffset, newText, author) {
   const createdVisibleTextSpan = startOffset === endOffset && newText.length > 0 ? {
     startOffset,
@@ -207290,7 +207387,7 @@ function isolateSimpleTextRangeInParagraphXml(input) {
   if (input.rangeStart < 0 || input.rangeEnd <= input.rangeStart) {
     return { ok: false, reason: "invalid-range" };
   }
-  const contextualRejection = rejectSimpleTextRangeContext(input.paragraphXml, input.rangeStart, input.rangeEnd, input.allowDisjointTracked ?? false);
+  const contextualRejection = rejectSimpleTextRangeContext(input.paragraphXml, input.rangeStart, input.rangeEnd, input.allowDisjointTracked ?? false, input.allowDisjointFields ?? false);
   if (contextualRejection)
     return { ok: false, reason: contextualRejection };
   const paragraphOpen = /^<([\w.-]+):p\b[^>]*>/.exec(input.paragraphXml);
@@ -207303,7 +207400,7 @@ function isolateSimpleTextRangeInParagraphXml(input) {
   }
   const runs = [];
   const runRe = /<([\w.-]+):r\b[^>]*>[\s\S]*?<\/\1:r>/g;
-  const ordinaryRunStarts = input.allowDisjointTracked ? new Map : null;
+  const ordinaryRunStarts = input.allowDisjointTracked || input.allowDisjointFields ? new Map : null;
   if (ordinaryRunStarts) {
     for (const piece of parseParagraphInlineMap(input.paragraphXml).leaves()) {
       if (piece.kind === "text" && piece.textRole === "visible" && piece.containerStack.length === 0 && !ordinaryRunStarts.has(piece.runCharStart)) {
@@ -207378,9 +207475,11 @@ function renderSimpleTextRunSlice(slice, options = {}) {
   }).join("");
   return `${slice.runOpenTag}${options.rPrXml ?? slice.rPrXml}${textXml}${slice.runCloseTag}`;
 }
-function rejectSimpleTextRangeContext(paragraphXml, rangeStart, rangeEnd, allowDisjointTracked) {
-  if (/<[\w.-]+:(?:fldSimple|fldChar|instrText|delInstrText)\b/.test(paragraphXml))
-    return "field";
+function rejectSimpleTextRangeContext(paragraphXml, rangeStart, rangeEnd, allowDisjointTracked, allowDisjointFields) {
+  if (/<[\w.-]+:(?:fldSimple|fldChar|instrText|delInstrText)\b/.test(paragraphXml)) {
+    if (!allowDisjointFields || !hasOnlyDisjointFields(paragraphXml, rangeStart, rangeEnd))
+      return "field";
+  }
   if (/<[\w.-]+:(?:commentRangeStart|commentRangeEnd|commentReference)\b/.test(paragraphXml)) {
     return "comment";
   }
@@ -207402,6 +207501,34 @@ function rejectSimpleTextRangeContext(paragraphXml, rangeStart, rangeEnd, allowD
     return "drawing";
   return null;
 }
+function hasOnlyDisjointFields(paragraphXml, rangeStart, rangeEnd) {
+  const fields = [];
+  function visit(pieces) {
+    for (const piece of pieces) {
+      if (piece.kind !== "container")
+        continue;
+      if (piece.containerKind === "complexField" || piece.containerKind === "fldSimple") {
+        if (rangeStart < piece.visibleEnd && rangeEnd > piece.visibleStart)
+          return false;
+        if (piece.containerKind === "complexField" && piece.resultCharStart === undefined)
+          return false;
+        fields.push({ start: piece.charStart, end: piece.charEnd });
+      } else if (!visit(piece.children))
+        return false;
+    }
+    return true;
+  }
+  if (!visit(parseParagraphInlineMap(paragraphXml).pieces))
+    return false;
+  let outsideFields = "";
+  let cursor = 0;
+  for (const field of fields) {
+    outsideFields += paragraphXml.slice(cursor, field.start);
+    cursor = field.end;
+  }
+  outsideFields += paragraphXml.slice(cursor);
+  return !/<[\w.-]+:(?:fldSimple|fldChar|instrText|delInstrText)\b/.test(outsideFields);
+}
 function hasTrackedOverlap(pieces, rangeStart, rangeEnd) {
   for (const piece of pieces) {
     if (piece.kind === "tracked" && rangeStart < piece.visibleEnd && rangeEnd > piece.visibleStart) {
@@ -247417,6 +247544,80 @@ function runHyperlinkWrapCommit(input) {
   if (!bytes)
     return rejected19(input.txId, "hyperlink-target-not-found");
   const paraXml = TD71.decode(bytes.subarray(paragraph.byteStart, paragraph.byteEnd));
+  const overlappingInsertions = parseParagraphInlineMap(paraXml).pieces.filter((piece) => piece.kind === "tracked" && piece.trackedKind === "ins" && piece.visibleStart < op.on.endOffset && piece.visibleEnd > op.on.startOffset);
+  if (overlappingInsertions.length > 0) {
+    if (overlappingInsertions.length !== 1)
+      return rejected19(input.txId, "hyperlink-tracked-or-comment-unsupported");
+    const insertion = overlappingInsertions[0];
+    const revisionId = Number(insertion.revisionId);
+    if (insertion.visibleStart > op.on.startOffset || insertion.visibleEnd < op.on.endOffset || !Number.isSafeInteger(revisionId) || !collectSessionCreatedTrackedChangeWIds(input.state).has(revisionId) || !insertion.rsid || !collectSessionCreatedTrackedChangeRsids(input.state).has(insertion.rsid) || classifyInsertionAuthoringOwnership(buildReviewIdentity(stamping.author), buildReviewIdentity({ name: insertion.author, email: insertion.email, initials: insertion.initials })) !== "same-user")
+      return rejected19(input.txId, "hyperlink-tracked-or-comment-unsupported");
+    const textbox = input.state.textboxRegistry.byStoryId.get(op.on.storyId);
+    if (textbox && textbox.alternateContentCounterparts.length > 1) {
+      return rejected19(input.txId, "hyperlink-text-range-unsupported");
+    }
+    const openingEnd = paraXml.indexOf(">", insertion.charStart) + 1;
+    const closingStart = paraXml.lastIndexOf("</", insertion.charEnd);
+    if (openingEnd <= insertion.charStart || closingStart < openingEnd) {
+      return rejected19(input.txId, "hyperlink-tracked-or-comment-unsupported");
+    }
+    const innerXml = paraXml.slice(openingEnd, closingStart);
+    const isolatedInner = isolateSimpleTextRangeInParagraphXml({
+      paragraphXml: `<w:p>${innerXml}</w:p>`,
+      rangeStart: op.on.startOffset - insertion.visibleStart,
+      rangeEnd: op.on.endOffset - insertion.visibleStart,
+      allowDisjointFields: true
+    });
+    if (!isolatedInner.ok)
+      return rejected19(input.txId, mapSimpleTextRangeIsolationReason(isolatedInner.reason));
+    const selectedRuns = isolatedInner.value.selectedRuns.map((run) => renderSimpleTextRunSlice(run, { rPrXml: ensureHyperlinkRunStyle(run, characterStyleId) })).join("");
+    const generatedReplacementXml = isolatedInner.value.beforeRunXml + buildHyperlinkFieldRunsXml({ target: op.target, metadata: op.metadata, resultRunsXml: selectedRuns }) + isolatedInner.value.afterRunXml;
+    const replacementStart = openingEnd + isolatedInner.value.replaceStart - "<w:p>".length;
+    const replacementEnd = openingEnd + isolatedInner.value.replaceEnd - "<w:p>".length;
+    const replacementByteStart = paragraph.byteStart + utf8ByteLength6(paraXml, replacementStart);
+    const replacementXml2 = closeNamespaceScope(generatedReplacementXml, {
+      w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
+      r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+    }, namespaceBindingsAtPosition(bytes, replacementByteStart), { referencedOnly: true });
+    if (replacementXml2 === null)
+      return rejected19(input.txId, "hyperlink-text-range-unsupported");
+    const documentPatches2 = [{
+      kind: "replaceBytes",
+      order: 0,
+      startByte: replacementByteStart,
+      endByte: paragraph.byteStart + utf8ByteLength6(paraXml, replacementEnd),
+      bytes: TE38.encode(replacementXml2)
+    }];
+    const perPart2 = {
+      [paragraph.partUri]: { kind: "modify", patches: documentPatches2 },
+      ...styleDependencies.value.perPart
+    };
+    return finalize6({
+      input,
+      storyId: op.on.storyId,
+      storyPartUri: paragraph.partUri,
+      sessionEffects: [{ after: compilerHyperlinkCarrier(paragraph.partUri, replacementByteStart, replacementXml2, true) }],
+      perPart: perPart2,
+      preconditions: [
+        buildLocalizedByteWindowPrecondition({ partUri: paragraph.partUri, bytes, patches: documentPatches2 }),
+        ...styleDependencies.value.preconditions
+      ],
+      extraPatchMaps: {},
+      createdRefs: [],
+      updatedRefs: [
+        { kind: "trackedChange", entityId: insertion.rsid, storyId: op.on.storyId },
+        { kind: "block", nodeId: op.on.paraId, storyId: op.on.storyId },
+        { kind: "text", storyId: op.on.storyId, blockId: op.on.paraId, range: { start: op.on.startOffset, end: op.on.endOffset } }
+      ],
+      indexRefreshScope: {
+        perPart: { [paragraph.partUri]: {
+          beforeWindow: { startByte: paragraph.byteStart, endByte: paragraph.byteEnd },
+          kind: "paragraph",
+          blockIds: [op.on.paraId]
+        } }
+      }
+    });
+  }
   const isolated = isolateSimpleTextRangeInParagraphXml({
     paragraphXml: paraXml,
     rangeStart: op.on.startOffset,
@@ -247970,6 +248171,9 @@ function buildHyperlinkRunXml(input) {
   return `<w:hyperlink${attrSegment}>` + runXml + `</w:hyperlink>`;
 }
 function buildTrackedHyperlinkFieldXml(input) {
+  return buildInsOpenTag2(input.stamp) + buildHyperlinkFieldRunsXml(input) + "</w:ins>";
+}
+function buildHyperlinkFieldRunsXml(input) {
   const instruction = buildHyperlinkFieldInstruction({
     href: input.target.kind === "external" ? input.target.url : undefined,
     anchor: input.target.kind === "anchor" ? input.target.anchor : undefined,
@@ -247977,7 +248181,7 @@ function buildTrackedHyperlinkFieldXml(input) {
     tooltip: input.metadata?.tooltip,
     targetFrame: input.metadata?.targetFrame
   });
-  return buildInsOpenTag2(input.stamp) + '<w:r><w:fldChar w:fldCharType="begin"/></w:r>' + `<w:r><w:instrText>${escapeText(instruction)}</w:instrText></w:r>` + '<w:r><w:fldChar w:fldCharType="separate"/></w:r>' + input.resultRunsXml + '<w:r><w:fldChar w:fldCharType="end"/></w:r>' + "</w:ins>";
+  return '<w:r><w:fldChar w:fldCharType="begin"/></w:r>' + `<w:r><w:instrText>${escapeText(instruction)}</w:instrText></w:r>` + '<w:r><w:fldChar w:fldCharType="separate"/></w:r>' + input.resultRunsXml + '<w:r><w:fldChar w:fldCharType="end"/></w:r>';
 }
 function buildDefaultHyperlinkResultRunXml(text, characterStyleId) {
   return `<w:r><w:rPr><w:rStyle w:val="${escapeAttr7(characterStyleId)}"/></w:rPr><w:t xml:space="preserve">${escapeText(text)}</w:t></w:r>`;
@@ -248120,7 +248324,7 @@ function finalize6(args) {
     backendExtensions: {
       storySurface: {
         family: "storyHyperlink",
-        storyLocal: opFromInput.kind === "hyperlinkWrap",
+        storyLocal: opFromInput.kind === "hyperlinkWrap" && Object.keys(args.perPart).every((partUri) => partUri === args.storyPartUri),
         changeMode: opFromInput.kind === "hyperlinkInsert" || opFromInput.kind === "hyperlinkWrap" ? opFromInput.changeMode ?? "direct" : "direct",
         targetBlockIds: args.updatedRefs.flatMap((ref3) => ref3.kind === "block" ? [ref3.nodeId] : []),
         atomCarrierContract: SD_DEFAULT_ATOM_CARRIER_CONTRACT
@@ -248178,8 +248382,10 @@ var init_compile_hyperlink_ops = __esm(() => {
   init_tracked_hyperlink_target();
   init_tracked_hyperlink_removal();
   init_xml_namespace_scope();
+  init_paragraph_inline_model();
   init_paragraph_para_id_attrs();
   init_revision_wid_allocator();
+  init_export_projection();
   init_semantic_style_dependencies();
   init_simple_text_run_split();
   TD71 = new TextDecoder;
@@ -312476,6 +312682,7 @@ function convertHtmlToFragment(html, options = {}) {
       range: { startOffset: 0, endOffset: html.length }
     }), limits.maxDiagnostics);
   }
+  attachSiblingListsToPreviousItems(tree);
   const treeViolation = inspectTreeLimits(tree, limits);
   if (treeViolation) {
     appendBoundedConversionDiagnostic(diagnostics, htmlDiagnostic({
@@ -312537,6 +312744,34 @@ function convertHtmlToFragment(html, options = {}) {
     diagnostics
   };
 }
+function attachSiblingListsToPreviousItems(parent) {
+  const pending = [parent];
+  while (pending.length > 0) {
+    const current = pending.pop();
+    if ("tagName" in current && (current.tagName === "ul" || current.tagName === "ol")) {
+      let previousItem = null;
+      const retained = [];
+      for (const child of current.childNodes) {
+        if (isElement(child) && child.tagName === "li") {
+          previousItem = child;
+          retained.push(child);
+        } else if (previousItem && isElement(child) && (child.tagName === "ul" || child.tagName === "ol")) {
+          previousItem.childNodes.push(child);
+          child.parentNode = previousItem;
+        } else {
+          if (!isText(child) || child.value.trim() !== "")
+            previousItem = null;
+          retained.push(child);
+        }
+      }
+      current.childNodes = retained;
+    }
+    for (const child of current.childNodes) {
+      if (isElement(child))
+        pending.push(child);
+    }
+  }
+}
 function parseErrorDiagnostic(error48) {
   return htmlDiagnostic({
     code: "conversion-malformed-input",
@@ -312914,9 +313149,9 @@ function convertSemanticList(root, context, inherited, path6) {
         level,
         path: canonicalPath,
         ...itemValue !== undefined && itemValue !== null ? { marker: `${itemValue}${definition.text?.endsWith(")") ? ")" : "."}` } : {},
-        content: content.length > 0 ? content : [
+        content: applyListItemParagraphMarkRunProps(content.length > 0 ? content : [
           paragraph2(context, [], undefined, itemPath, context.droppedContentCount === droppedContentStart)
-        ]
+        ], itemContext.runProps)
       });
       for (let nestedIndex = 0;nestedIndex < child.childNodes.length; nestedIndex += 1) {
         const nested = child.childNodes[nestedIndex];
@@ -312984,7 +313219,7 @@ function convertSemanticList(root, context, inherited, path6) {
         level,
         path: canonicalPath,
         ...itemValue !== undefined && itemValue !== null ? { marker: `${itemValue}${definition.text?.endsWith(")") ? ")" : "."}` } : {},
-        content: nestedContent
+        content: applyListItemParagraphMarkRunProps(nestedContent, itemContext.runProps)
       });
     }
     if (nestedItems.length === 0)
@@ -313098,7 +313333,7 @@ function convertWordListGroup(group, context, inherited) {
       level: descriptor.level,
       path: canonicalPath,
       ...exceptionalMarker ? { marker: exceptionalMarker } : {},
-      content: applyWordListParagraphMarkRunProps(itemContent, itemContext.runProps)
+      content: applyListItemParagraphMarkRunProps(itemContent, itemContext.runProps)
     });
     previousLevel = descriptor.level;
   }
@@ -313110,7 +313345,7 @@ function convertWordListGroup(group, context, inherited) {
     list: { levels: [...levels.values()].sort((a, b) => a.level - b.level), items }
   };
 }
-function applyWordListParagraphMarkRunProps(content, runProps) {
+function applyListItemParagraphMarkRunProps(content, runProps) {
   if (Object.keys(runProps).length === 0)
     return content;
   let applied = false;
@@ -326322,22 +326557,50 @@ function comparablePlainTokenVariants(plan, plain) {
   return variants;
 }
 function normalizeRepresentedListMarkers(plan, lines) {
-  const listTexts = plan.blocks.flatMap((block) => block.kind === "paragraph" && block.listIntent ? [comparableText(blockText(block))] : []);
-  if (listTexts.length === 0)
+  const representedTokens = [];
+  const listStarts = new Set;
+  for (const block of plan.blocks) {
+    const tokens = comparableTokens(blockText(block));
+    if (tokens.length > 0 && block.kind === "paragraph" && block.listIntent) {
+      listStarts.add(representedTokens.length);
+    }
+    for (const token of tokens)
+      representedTokens.push(token);
+  }
+  if (listStarts.size === 0)
     return null;
-  let listIndex = 0;
+  let tokenIndex = 0;
+  const matchesNext = (tokens) => tokens.length > 0 && tokens.every((token, index2) => token === representedTokens[tokenIndex + index2]);
   let changed = false;
   const normalized = lines.map((line) => {
-    if (!hasPlainListMarker(line) || listIndex >= listTexts.length)
+    const tokens = comparableTokens(line);
+    if (matchesNext(tokens)) {
+      tokenIndex += tokens.length;
       return line;
-    const withoutMarker = stripPlainListMarker(line);
-    if (comparableText(withoutMarker) !== listTexts[listIndex])
+    }
+    if (!listStarts.has(tokenIndex))
+      return line;
+    const withoutMarker = stripRepresentedListMarker(line);
+    if (withoutMarker === null)
       return line;
-    listIndex += 1;
+    const withoutMarkerTokens = comparableTokens(withoutMarker);
+    if (!matchesNext(withoutMarkerTokens))
+      return line;
+    tokenIndex += withoutMarkerTokens.length;
     changed = true;
     return withoutMarker;
   });
-  return changed && listIndex === listTexts.length ? normalized : null;
+  return changed && tokenIndex === representedTokens.length ? normalized : null;
+}
+function stripRepresentedListMarker(line) {
+  if (hasPlainListMarker(line))
+    return stripPlainListMarker(line);
+  const separator = line.indexOf("\t");
+  if (separator < 1)
+    return null;
+  if (!/^(?:o|[\uE000-\uF8FF])$/u.test(line.slice(0, separator).trim()))
+    return null;
+  return line.slice(separator).replace(/^\t+/u, "");
 }
 function hasPlainListMarker(value2) {
   return PLAIN_LIST_MARKER_PATTERN.test(value2);
@@ -326373,7 +326636,7 @@ function isSubsequence(needles, haystack) {
 var PLAIN_LIST_MARKER_PATTERN;
 var init_html_plain_reconciliation = __esm(() => {
   init_contracts();
-  PLAIN_LIST_MARKER_PATTERN = /^(?:[•◦▪‣⁃●○■*+-]|\d{1,9}[.)]|[A-Za-z][.)]|[ivxlcdmIVXLCDM]{1,8}[.)])(?:[\t ]+)/u;
+  PLAIN_LIST_MARKER_PATTERN = /^(?:[•◦▪‣⁃●○■□▫◻◽*+-]|\d{1,9}[.)]|[A-Za-z][.)]|[ivxlcdmIVXLCDM]{1,8}[.)])(?:[\t ]+)/u;
 });
 
 // ../../../v2/document-api-v2-adapter/dist/clipboard/parse-v1-slice.js
@@ -328508,15 +328771,14 @@ function* serializeSelectionRangeSteps(context, target, includeHtml, options) {
     let numbering = properties.numbering;
     const listState = readListStateForSession(context.session, resolved.storyId, entry.blockId);
     let listKind = listState?.isListItem ? listState.numFmt === "bullet" ? "bullet" : listState.numFmt ? "ordered" : undefined : undefined;
+    const marker = fullyCovered || listKind ? resolveNumberingLevelForMarker({
+      resolverParams: styleModel.resolverParams,
+      numId: listState?.isListItem && listState.numId != null ? Number(listState.numId) : properties.numbering ? Number(properties.numbering.numId) : undefined,
+      ilvl: listState?.isListItem ? listState.ilvl : properties.numbering ? Number(properties.numbering.ilvl) : undefined,
+      paragraphStyleId: properties.styleRef
+    }) : null;
     if (fullyCovered) {
-      const model = copyStyleModel ?? (copyStyleModel = compileCopyStyleModel(context));
-      const marker = resolveNumberingLevelForMarker({
-        resolverParams: model.resolverParams,
-        numId: properties.numbering ? Number(properties.numbering.numId) : undefined,
-        ilvl: properties.numbering ? Number(properties.numbering.ilvl) : undefined,
-        paragraphStyleId: properties.styleRef
-      });
-      if (marker.definition && !marker.definition.suppressed) {
+      if (marker?.definition && !marker.definition.suppressed) {
         numbering = {
           numId: String(marker.definition.numId),
           ilvl: String(marker.definition.ilvl)
@@ -328564,7 +328826,8 @@ function* serializeSelectionRangeSteps(context, target, includeHtml, options) {
           ...cellFormatting
         }
       } : {},
-      ...listKind ? { listKind } : {},
+      ...listKind ? { listKind, listLevel: listState?.isListItem ? listState.ilvl : listLevel ?? 0 } : {},
+      ...listKind && marker?.definition ? { listMarkerStyle: portableListMarkerStyle(marker.definition, styleModel, paragraphXml) } : {},
       ...semanticHeadingLevel != null && semanticHeadingLevel >= 1 && semanticHeadingLevel <= 6 ? { headingLevel: semanticHeadingLevel } : {},
       parts
     });
@@ -329774,14 +330037,14 @@ function paragraphPaintedLength(xml) {
   const map3 = parseParagraphInlineMap(xml);
   return map3.visibleLength + map3.leaves().filter(isVisibleZeroWidthObjectPiece).length;
 }
-function blockInlineHtml(block, assets) {
-  return block.parts.map((part) => renderHtmlPart(part, assets)).join("");
+function blockInlineHtml(block, assets, defaultTextColor) {
+  return block.parts.map((part) => renderHtmlPart(part, assets, defaultTextColor)).join("");
 }
-function renderHtmlPart(part, assets) {
+function renderHtmlPart(part, assets, defaultTextColor) {
   if (part.kind === "break")
     return "<br/>";
   if (part.kind === "run")
-    return renderHtmlRun(part.run);
+    return renderHtmlRun(part.run, defaultTextColor);
   if (part.kind === "image") {
     const asset = assets.get(part.image.assetId);
     if (!asset)
@@ -329790,18 +330053,17 @@ function renderHtmlPart(part, assets) {
     return `<img src="data:${asset.mimeType};base64,${asset.data}" width="${widthPx}" height="${heightPx}"` + (alt ? ` alt="${escapeHtmlAttribute(alt)}"` : "") + (title2 ? ` title="${escapeHtmlAttribute(title2)}"` : "") + "/>";
   }
   if (part.kind === "sdt")
-    return part.parts.map((child) => renderHtmlPart(child, assets)).join("");
+    return part.parts.map((child) => renderHtmlPart(child, assets, defaultTextColor)).join("");
   const href = part.target.kind === "external" ? part.target.url : `#${part.target.anchor}`;
   const title = part.tooltip ? ` title="${escapeHtmlAttribute(part.tooltip)}"` : "";
-  return `<a href="${escapeHtmlAttribute(href)}"${title}>${part.parts.map((child) => renderHtmlPart(child, assets)).join("")}</a>`;
+  return `<a href="${escapeHtmlAttribute(href)}"${title}>${part.parts.map((child) => renderHtmlPart(child, assets, defaultTextColor)).join("")}</a>`;
 }
 function buildHtmlFlavor(grouped, assets) {
   const out = [];
-  let openList = null;
+  const openLists = [];
   const closeList = () => {
-    if (openList) {
-      out.push(`</${openList}>`);
-      openList = null;
+    while (openLists.length > 0) {
+      out.push(`</li></${openLists.pop().tag}>`);
     }
   };
   for (const entry of grouped) {
@@ -329811,15 +330073,41 @@ function buildHtmlFlavor(grouped, assets) {
       continue;
     }
     const block = entry.block;
-    const inline = blockInlineHtml(block, assets);
+    const inline = blockInlineHtml(block, assets, block.listMarkerStyle?.color && block.listMarkerStyle.color !== "000000" ? "000000" : undefined);
     if (block.listKind) {
       const tag = block.listKind === "bullet" ? "ul" : "ol";
-      if (openList !== tag) {
-        closeList();
-        out.push(`<${tag}>`);
-        openList = tag;
-      }
-      out.push(`<li>${inline}</li>`);
+      const styleType = block.listMarkerStyle?.type;
+      const level = block.listLevel ?? 0;
+      if (openLists.length > 0)
+        openLists[0].sourceLevel = Math.min(openLists[0].sourceLevel, level);
+      while (openLists.length > 1 && openLists[openLists.length - 1].sourceLevel > level) {
+        out.push(`</li></${openLists.pop().tag}>`);
+      }
+      const depth = openLists.length === 0 ? 0 : level > openLists[openLists.length - 1].sourceLevel ? openLists.length : openLists.length - 1;
+      if (openLists.length === depth + 1) {
+        out.push("</li>");
+        if (openLists[depth].tag !== tag || openLists[depth].styleType !== styleType) {
+          out.push(`</${openLists.pop().tag}>`);
+        }
+      }
+      if (openLists.length === depth) {
+        const listStyles = [
+          ...styleType ? [`list-style-type: ${styleType}`] : [],
+          ...openLists[depth - 1]?.currentItemHasMarkerColor ? ["color: #000000"] : []
+        ];
+        const orderedType = tag === "ol" ? orderedListTypeAttribute(styleType) : undefined;
+        out.push(`<${tag}${orderedType ? ` type="${orderedType}"` : ""}` + `${listStyles.length > 0 ? ` style="${listStyles.join("; ")}"` : ""}>`);
+        openLists.push({ tag, sourceLevel: level, ...styleType ? { styleType } : {}, currentItemHasMarkerColor: false });
+      }
+      const markerColor = block.listMarkerStyle?.color;
+      const previousItemHadColoredMarker = openLists[openLists.length - 1].currentItemHasMarkerColor;
+      const itemColor = markerColor && markerColor !== "000000" ? markerColor : previousItemHadColoredMarker ? "000000" : undefined;
+      const itemStyles = [
+        ...styleType ? [`list-style-type: ${styleType}`] : [],
+        ...itemColor ? [`color: #${itemColor}`] : []
+      ];
+      out.push(`<li${itemStyles.length > 0 ? ` style="${itemStyles.join("; ")}"` : ""}>${inline}`);
+      openLists[openLists.length - 1].currentItemHasMarkerColor = Boolean(markerColor && markerColor !== "000000");
       continue;
     }
     closeList();
@@ -329831,6 +330119,63 @@ function buildHtmlFlavor(grouped, assets) {
   closeList();
   return out.join("");
 }
+function portableListMarkerStyle(definition2, model, paragraphXml) {
+  const glyph = definition2.lvlText?.trim();
+  const type = definition2.numFmt === "bullet" ? glyph === "•" || glyph === "●" || glyph === "" ? "disc" : glyph === "◦" || glyph === "○" ? "circle" : glyph === "▪" || glyph === "■" || glyph === "◼" ? "square" : undefined : portableOrderedListStyleType(definition2.numFmt);
+  const runContext = {
+    themeColors: model.themeColors,
+    themeFontScheme: model.themeFontScheme
+  };
+  const directParagraphProperties = parseWordParagraphPropertiesXml(paragraphXml);
+  const resolvedParagraphProperties = model.resolveParagraph({ inlineProps: directParagraphProperties });
+  const markerRun = model.resolveRun({
+    inlineRpr: parseWordRunPropertiesXml(extractParagraphMarkRPrXml(paragraphXml)),
+    resolvedParagraphProperties,
+    isListNumber: true,
+    numberingDefinedInline: directParagraphProperties.numberingProperties != null
+  });
+  const markerColor = normalizeRunAttrsFromOoxml(markerRun, runContext).color;
+  const color2 = markerColor && /^#[0-9a-f]{6}$/i.test(markerColor) ? markerColor.slice(1).toUpperCase() : undefined;
+  return {
+    ...type ? { type } : {},
+    ...color2 ? { color: color2 } : {}
+  };
+}
+function portableOrderedListStyleType(numFmt) {
+  switch (numFmt) {
+    case "decimal":
+      return "decimal";
+    case "decimalZero":
+      return "decimal-leading-zero";
+    case "lowerLetter":
+      return "lower-alpha";
+    case "upperLetter":
+      return "upper-alpha";
+    case "lowerRoman":
+      return "lower-roman";
+    case "upperRoman":
+      return "upper-roman";
+    default:
+      return;
+  }
+}
+function orderedListTypeAttribute(styleType) {
+  switch (styleType) {
+    case "decimal":
+    case "decimal-leading-zero":
+      return "1";
+    case "lower-alpha":
+      return "a";
+    case "upper-alpha":
+      return "A";
+    case "lower-roman":
+      return "i";
+    case "upper-roman":
+      return "I";
+    default:
+      return;
+  }
+}
 function tableCellHtmlStyle(cell) {
   const styles = [];
   if (cell.shadingColor)
@@ -329861,14 +330206,15 @@ function tableCellHtmlStyle(cell) {
   }
   return styles.length > 0 ? ` style="${styles.join("; ")}"` : "";
 }
-function renderHtmlRun(run) {
+function renderHtmlRun(run, defaultTextColor) {
   let html = escapeHtmlText(run.text);
-  const marks = run.marks;
-  if (!marks)
+  if (!run.marks && !defaultTextColor)
     return html;
+  const marks = run.marks ?? {};
   const styles = [];
-  if (marks.color)
-    styles.push(`color: #${marks.color}`);
+  const color2 = marks.color ?? defaultTextColor;
+  if (color2)
+    styles.push(`color: #${color2}`);
   if (marks.fontSizePt)
     styles.push(`font-size: ${marks.fontSizePt}pt`);
   if (marks.fontFamily)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/mcp",
-  "version": "1.7.0-next.12",
+  "version": "1.7.0-next.14",
   "description": "Model Context Protocol server for SuperDoc, giving an AI agent tools to read and edit .docx files.",
   "type": "module",
   "license": "AGPL-3.0",
@@ -24,13 +24,13 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@superdoc/sdk": "2.20.0-next.12",
+    "@superdoc/sdk": "2.20.0-next.14",
     "debug": "^4.4.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "superdoc": "2.23.0-next.12",
-    "@superdoc/docx-engine": "0.22.0-next.12",
+    "superdoc": "2.23.0-next.14",
+    "@superdoc/docx-engine": "0.22.0-next.14",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",