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

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.14";
+var SDK_VERSION = "2.20.0-next.16";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { accessSync, chmodSync, constants, existsSync, statSync } from "node:fs";
@@ -121556,6 +121556,12 @@ function validateClipboardPlan(plan, operationName) {
   if (!Array.isArray(plan.diagnostics)) {
     throw new DocumentApiValidationError("INVALID_INPUT", `${operationName} plan.diagnostics must be an array.`);
   }
+  if (plan.sourceStyleContext !== undefined && plan.sourceStyleContext !== null) {
+    const source = plan.sourceStyleContext;
+    if (typeof source !== "object" || Array.isArray(source) || typeof source.documentEpoch !== "string" || source.documentEpoch.length === 0 || source.documentEpoch.length > 255 || typeof source.digest !== "string" || !/^[a-f0-9]{64}$/.test(source.digest)) {
+      throw new DocumentApiValidationError("INVALID_INPUT", `${operationName} plan.sourceStyleContext is invalid.`);
+    }
+  }
 }
 function validatePasteFragment(fragment2, operationName) {
   if (!fragment2 || typeof fragment2 !== "object") {
@@ -195904,7 +195910,7 @@ function isValidPasteRunMarks(value) {
     if (marks[key2] !== undefined && typeof marks[key2] !== "boolean")
       return false;
   }
-  if (marks.color !== undefined && (typeof marks.color !== "string" || !/^[0-9A-F]{6}$/i.test(marks.color))) {
+  if (marks.color !== undefined && (typeof marks.color !== "string" || marks.color !== "auto" && !/^[0-9A-F]{6}$/i.test(marks.color))) {
     return false;
   }
   if (marks.highlight !== undefined) {
@@ -196138,9 +196144,11 @@ function hasOnlyKeys(value, keys) {
   return Object.keys(value).every((key2) => allowed.has(key2));
 }
 function toPasteTextRunSpec(run) {
+  const characterStyleId = run.characterStyleId ?? run.styleRef;
   return {
     text: run.text,
     ...run.marks ? { marks: run.marks } : {},
+    ...characterStyleId ? { characterStyleId } : {},
     ...run.commentIds && run.commentIds.length > 0 ? { commentIds: run.commentIds } : {},
     ...run.trackedInsertion ? { trackedInsertion: true } : {}
   };
@@ -196284,12 +196292,14 @@ function renderPasteRun(run, options = {}) {
     const local = run.kind === "footnoteRef" ? "footnoteReference" : "endnoteReference";
     return `<w:r><w:rPr><w:rStyle w:val="${style}"/></w:rPr><w:${local} w:id="${escapeXmlAttribute(run.noteId)}"/></w:r>`;
   }
+  const characterStyleId = (run.kind === undefined || run.kind === "text" ? run.characterStyleId : undefined) ?? options.characterStyleId;
+  const runOptions = characterStyleId ? { characterStyleId } : options;
   if (run.kind === "lineBreak") {
-    return `<w:r>${renderPasteRunProperties(run, options)}<w:br/></w:r>`;
+    return `<w:r>${renderPasteRunProperties(run, runOptions)}<w:br/></w:r>`;
   }
   if (!("text" in run))
     return "";
-  const rPr = renderPasteRunProperties(run, options);
+  const rPr = renderPasteRunProperties(run, runOptions);
   if (run.text.length === 0)
     return "";
   const segments = run.text.split("\t");
@@ -196361,7 +196371,11 @@ function renderRunPropertiesXml(marks, options = {}) {
   }
   if (marks.strike !== undefined)
     parts.push(marks.strike ? "<w:strike/>" : '<w:strike w:val="0"/>');
-  if (marks.color && isHexColor(marks.color)) {
+  if (marks.strike === false && options.characterStyleId)
+    parts.push('<w:dstrike w:val="0"/>');
+  if (marks.color === "auto") {
+    parts.push('<w:color w:val="auto"/>');
+  } else if (marks.color && isHexColor(marks.color)) {
     parts.push(`<w:color w:val="${escapeXmlAttribute(marks.color.toUpperCase())}"/>`);
   }
   if (typeof marks.fontSizePt === "number" && Number.isFinite(marks.fontSizePt) && marks.fontSizePt > 0) {
@@ -196372,7 +196386,7 @@ function renderRunPropertiesXml(marks, options = {}) {
     parts.push(`<w:szCs w:val="${Math.round(marks.fontSizeCsPt * 2)}"/>`);
   if (marks.underline !== undefined)
     parts.push(`<w:u w:val="${marks.underline ? "single" : "none"}"/>`);
-  const highlightXml = renderHighlightOrShadingXml(marks.highlight);
+  const highlightXml = marks.highlight?.trim().toLowerCase() === "none" ? '<w:highlight w:val="none"/>' : renderHighlightOrShadingXml(marks.highlight);
   if (highlightXml)
     parts.push(highlightXml);
   if (isPasteVerticalAlign(marks.verticalAlign)) {
@@ -241698,15 +241712,26 @@ function normalizeMatchDestinationParagraph(block) {
     runs: block.runs.map(withoutSourceMarks),
     ...block.sourcePath ? { sourcePath: block.sourcePath } : {},
     ...block.inlines ? {
-      inlines: block.inlines.map((inline) => inline.kind === "text" ? withoutSourceMarks(inline) : inline.kind === "hyperlink" ? {
-        ...inline,
-        inlines: inline.inlines.map((child) => child.kind === "text" ? withoutSourceMarks(child) : child)
-      } : inline)
+      inlines: block.inlines.map(withoutSourceInlineFormatting)
     } : {}
   };
 }
+function withoutSourceInlineFormatting(inline) {
+  if (inline.kind === "text")
+    return withoutSourceMarks(inline);
+  if (inline.kind === "sdt") {
+    return withoutSourceSdtFormatting(inline);
+  }
+  if (inline.kind === "hyperlink") {
+    return { ...inline, inlines: inline.inlines.map((child) => child.kind === "text" ? withoutSourceMarks(child) : child) };
+  }
+  return inline;
+}
+function withoutSourceSdtFormatting(inline) {
+  return { ...inline, inlines: inline.inlines.map((child) => child.kind === "text" ? withoutSourceMarks(child) : child.kind === "sdt" ? withoutSourceSdtFormatting(child) : child) };
+}
 function withoutSourceMarks(run) {
-  const { marks: _sourceMarks, ...retained } = run;
+  const { marks: _sourceMarks, styleRef: _sourceStyle, ...retained } = run;
   return retained;
 }
 var init_match_destination_paste = __esm(() => {
@@ -245978,6 +246003,9 @@ function explicitPasteStyleRefsExist(state, blocks) {
   const inspectParagraph = (block) => {
     if (block.styleRef && !block.pPrXml)
       references.push({ styleId: block.styleRef, type: "paragraph" });
+    for (const styleId of characterStyleRefsInParagraph(block)) {
+      references.push({ styleId, type: "character" });
+    }
   };
   for (const block of walkPasteBlocks(blocks)) {
     if (block.kind === "paragraph")
@@ -245987,6 +246015,28 @@ function explicitPasteStyleRefsExist(state, blocks) {
   }
   return explicitStyleReferencesExist(state, references);
 }
+function characterStyleRefsInParagraph(block) {
+  const refs = [];
+  for (const run of block.runs) {
+    if (typeof run.styleRef === "string" && run.styleRef.length > 0)
+      refs.push(run.styleRef);
+  }
+  const walkInlines = (inlines) => {
+    if (!inlines)
+      return;
+    for (const inline of inlines) {
+      if (inline.kind === "text") {
+        if (typeof inline.styleRef === "string" && inline.styleRef.length > 0)
+          refs.push(inline.styleRef);
+        continue;
+      }
+      if (inline.kind === "hyperlink" || inline.kind === "sdt")
+        walkInlines(inline.inlines);
+    }
+  };
+  walkInlines(block.inlines);
+  return refs;
+}
 function resolveSemanticStyleBlocks(blocks, styleIdByRole) {
   const paragraph = (block) => {
     if (!block.semanticStyleRole)
@@ -246505,6 +246555,8 @@ function validateParagraphBlock(block, budget) {
   for (const run of block.runs) {
     if (typeof run.text !== "string")
       return { ok: false, reason: "paste-structure-unsupported" };
+    if (!isValidPasteCharacterStyleRef(run.styleRef))
+      return { ok: false, reason: "paste-structure-unsupported" };
     if (!isValidPasteRunMarks(run.marks))
       return { ok: false, reason: "paste-structure-unsupported" };
     if (block.inlines === undefined && !recordSourcePath(run.sourcePath, budget.sourcePaths)) {
@@ -246527,7 +246579,7 @@ function validatePasteInline(inline, budget, depth = 0) {
     return (inline.controlType === "text" || inline.controlType === "richText") && isValidOptionalXmlAttributeText(inline.tag, 255) && isValidOptionalXmlAttributeText(inline.alias, 255) && Array.isArray(inline.inlines) && inline.inlines.length > 0 && inline.inlines.every((child) => child.kind === "text" || child.kind === "lineBreak" || child.kind === "sdt") && inline.inlines.every((child) => validatePasteInline(child, budget, depth + 1));
   }
   if (inline.kind === "text") {
-    return typeof inline.text === "string" && !hasUnsupportedControlChar(inline.text) && isValidPasteRunMarks(inline.marks);
+    return typeof inline.text === "string" && isValidPasteCharacterStyleRef(inline.styleRef) && !hasUnsupportedControlChar(inline.text) && isValidPasteRunMarks(inline.marks);
   }
   if (inline.kind === "lineBreak")
     return true;
@@ -246572,12 +246624,15 @@ function hasMatchingInlineTextProjection(block) {
   });
   return textInlines.length === block.runs.length && textInlines.every((inline, index) => {
     const run = block.runs[index];
-    return inline.text === run.text && haveEqualRunMarks(inline.marks, run.marks);
+    return inline.text === run.text && inline.styleRef === run.styleRef && haveEqualRunMarks(inline.marks, run.marks);
   });
 }
 function haveEqualRunMarks(left, right) {
   return left?.boldCs === right?.boldCs && left?.italicCs === right?.italicCs && left?.caps === right?.caps && left?.smallCaps === right?.smallCaps && left?.fontSizeCsPt === right?.fontSizeCsPt && left?.bold === right?.bold && left?.italic === right?.italic && left?.underline === right?.underline && left?.strike === right?.strike && left?.color === right?.color && left?.highlight === right?.highlight && left?.fontSizePt === right?.fontSizePt && left?.fontFamily === right?.fontFamily && left?.verticalAlign === right?.verticalAlign;
 }
+function isValidPasteCharacterStyleRef(value) {
+  return value === undefined || typeof value === "string" && value.length > 0 && isValidOptionalXmlAttributeText(value, 255);
+}
 function isValidOptionalXmlAttributeText(value, maxLength) {
   return value === undefined || typeof value === "string" && value.length <= maxLength && !hasUnsupportedXmlAttributeChar(value);
 }
@@ -326648,6 +326703,38 @@ var init_parse_v1_slice = __esm(() => {
   init_src3();
 });
 
+// ../../../v2/document-api-v2-adapter/dist/clipboard/style-context.js
+function clipboardStyleContext(context) {
+  const parts = [
+    readStyleDefinitionsPartBytes(context),
+    ...["/word/numbering.xml", "/word/theme/theme1.xml", "/word/settings.xml", "/word/fontTable.xml"].map((uri) => getSDDocumentSessionInternalPartBytes(context.session, uri) ?? null)
+  ];
+  return {
+    documentEpoch: getSDDocumentSessionInternalSourceCommit(context.session).documentEpoch,
+    digest: sha256HexSync(new TextEncoder().encode(JSON.stringify(parts.map((bytes) => bytes ? sha256HexSync(bytes) : null))))
+  };
+}
+function clipboardStyleContextMatches(context, value2) {
+  const source = normalizeClipboardStyleContext(value2);
+  if (!source)
+    return false;
+  if (source.documentEpoch === getSDDocumentSessionInternalSourceCommit(context.session).documentEpoch)
+    return true;
+  return source.digest === clipboardStyleContext(context).digest;
+}
+function normalizeClipboardStyleContext(value2) {
+  if (!value2 || typeof value2 !== "object" || Array.isArray(value2))
+    return null;
+  const source = value2;
+  if (typeof source.documentEpoch !== "string" || source.documentEpoch.length === 0 || source.documentEpoch.length > 255 || typeof source.digest !== "string" || !/^[a-f0-9]{64}$/.test(source.digest))
+    return null;
+  return { documentEpoch: source.documentEpoch, digest: source.digest };
+}
+var init_style_context = __esm(() => {
+  init_sd_document_session_internal();
+  init_part();
+});
+
 // ../../../v2/document-api-v2-adapter/dist/clipboard/parse-v2-fragment.js
 function parseV2FragmentPayload(payload, mime = SUPERDOC_V2_CLIPBOARD_MIME) {
   const item = payload.items.find((candidate2) => candidate2.type === mime);
@@ -326683,9 +326770,11 @@ function parseV2FragmentPayload(payload, mime = SUPERDOC_V2_CLIPBOARD_MIME) {
       ]
     };
   }
+  const prepared = prepareClipboardPlan(fragment4.fragment, "superdoc-v2-fragment", fragment4.fragment.diagnostics ?? []);
   return {
     ok: true,
-    ...prepareClipboardPlan(fragment4.fragment, "superdoc-v2-fragment", fragment4.fragment.diagnostics ?? [])
+    ...prepared,
+    plan: { ...prepared.plan, sourceStyleContext: normalizeClipboardStyleContext(parsed.sourceStyleContext) }
   };
 }
 function normalizeV2WireFragment(value2) {
@@ -326809,9 +326898,13 @@ function normalizeParagraphBlock(value2, path7, version2, allowHeading) {
     const review = normalizeRunReviewFields(run, [...path7, "runs", runIndex]);
     if (isPlanFailure(review))
       return review;
+    const styleRef = normalizeCharacterStyleRef(run.styleRef, [...path7, "runs", runIndex, "styleRef"]);
+    if (isPlanFailure(styleRef))
+      return styleRef;
     runs.push({
       text: run.text,
       ...marks ? { marks } : {},
+      ...styleRef ? { styleRef } : {},
       ...sourcePath2 ? { sourcePath: sourcePath2 } : {},
       ...review
     });
@@ -326829,7 +326922,7 @@ function normalizeParagraphBlock(value2, path7, version2, allowHeading) {
       inlines.push(normalized);
     }
     const projected = inlines.flatMap(projectInlineText);
-    if (projected.length !== runs.length || projected.some((inline, runIndex) => inline.text !== runs[runIndex]?.text || JSON.stringify(inline.marks ?? {}) !== JSON.stringify(runs[runIndex]?.marks ?? {}))) {
+    if (projected.length !== runs.length || projected.some((inline, runIndex) => inline.text !== runs[runIndex]?.text || JSON.stringify(inline.marks ?? {}) !== JSON.stringify(runs[runIndex]?.marks ?? {}) || (inline.styleRef ?? undefined) !== (runs[runIndex]?.styleRef ?? undefined))) {
       return structureFailure("Paragraph runs must equal the text projection of inlines.", path7);
     }
   }
@@ -326905,6 +326998,14 @@ function normalizeBlockSdts(value2, path7) {
 function validSdtMetadata(value2) {
   return (value2.lockMode === undefined || value2.lockMode === "unlocked" || value2.lockMode === "sdtLocked" || value2.lockMode === "contentLocked" || value2.lockMode === "sdtContentLocked") && (value2.multiline === undefined || value2.controlType === "text" && typeof value2.multiline === "boolean");
 }
+function normalizeCharacterStyleRef(value2, path7) {
+  if (value2 === undefined)
+    return;
+  if (typeof value2 !== "string" || value2.length === 0 || !isXml10SafeAttributeValue(value2) || value2.length > 255) {
+    return structureFailure("Paste run styleRef must be a non-empty XML-safe style id of at most 255 characters.", path7);
+  }
+  return value2;
+}
 function projectInlineText(inline) {
   if (inline.kind === "text")
     return [inline];
@@ -326960,10 +327061,14 @@ function normalizeInline(value2, path7, allowHyperlink, depth = 0) {
     const review = normalizeRunReviewFields(value2, path7);
     if (isPlanFailure(review))
       return review;
+    const styleRef = normalizeCharacterStyleRef(value2.styleRef, [...path7, "styleRef"]);
+    if (isPlanFailure(styleRef))
+      return styleRef;
     return {
       kind: "text",
       text: value2.text,
       ...marks ? { marks } : {},
+      ...styleRef ? { styleRef } : {},
       ...sourcePath ? { sourcePath } : {},
       ...review
     };
@@ -327545,8 +327650,8 @@ function normalizeMarks2(value2, path7) {
     out[key2] = value2[key2];
   }
   if (value2.color !== undefined) {
-    if (typeof value2.color !== "string" || !/^#?[0-9A-Fa-f]{6}$/.test(value2.color)) {
-      return structureFailure("Paste run color must be a six-digit RGB value.", [...path7, "color"]);
+    if (typeof value2.color !== "string" || value2.color !== "auto" && !/^#?[0-9A-Fa-f]{6}$/.test(value2.color)) {
+      return structureFailure("Paste run color must be a six-digit RGB value or auto.", [...path7, "color"]);
     }
     out.color = value2.color.replace(/^#/, "");
   }
@@ -327606,6 +327711,7 @@ var init_parse_v2_fragment = __esm(() => {
   init_contracts();
   init_fragment_output_budget();
   init_hyperlink_values();
+  init_style_context();
   RUN_MARK_KEYS = new Set([
     "boldCs",
     "italicCs",
@@ -327982,10 +328088,23 @@ function planFromPlainText(text4, plainFallback) {
     ...prepareClipboardPlan(fragment4, "plain-text", [], plainFallback)
   };
 }
-function planFromHtml(payload, html, options) {
+function createPortableHtmlInsertPlan(payload, options = {}) {
+  const portable = { ...payload, items: payload.items.filter((item) => item.type === "text/html" || item.type === "text/plain") };
+  if (estimatePayloadBytes(portable.items) > (options.maxBytes ?? DEFAULT_MAX_CLIPBOARD_BYTES)) {
+    return failPlan("paste-payload-too-large", "Clipboard payload exceeds the configured size cap.", "html");
+  }
+  const html = readStringItem(portable, "text/html");
+  if (html === null)
+    return failPlan("paste-no-faithful-representation", "No portable HTML flavor is available.", "html");
+  return planFromHtml(portable, html, options, true);
+}
+function planFromHtml(payload, html, options, rejectUnsafeContent = false) {
   const rewritten = rewriteWordNoteClipboardHtml(html);
   const converted = convertContentToFragment({ format: "html", source: rewritten });
   const diagnostics = converted.diagnostics.map(toClipboardHtmlDiagnostic);
+  if (rejectUnsafeContent && diagnostics.some((entry) => entry.reason === "paste-security-rejected")) {
+    return failPlan("paste-security-rejected", "The portable HTML flavor contains unsafe content.", "html");
+  }
   const fatal = converted.diagnostics.find((entry) => entry.severity === "error");
   if (fatal) {
     return fallbackFromFatalHtml(payload, options, fatal, diagnostics);
@@ -328689,7 +328808,11 @@ function* serializeSelectionRangeSteps(context, target, includeHtml, options) {
     const selectedInlineControl = options?.wholeParagraphs !== true && startEntry.ordinal === endEntry.ordinal && map3.pieces.some((piece) => piece.kind === "container" && piece.containerKind === "sdt" && piece.visibleStart === from && piece.visibleEnd === to);
     const fullyCovered = !selectedInlineControl && from === 0 && to === map3.visibleLength && (options?.wholeParagraphs === true || startEntry.ordinal !== endEntry.ordinal || properties.styleRef !== undefined || properties.numbering !== undefined || hasParagraphProperties(paragraphXml));
     const styleModel = copyStyleModel ?? (copyStyleModel = compileCopyStyleModel(context));
-    const styleContext = copyStyleContext(styleModel, properties.styleRef);
+    const styleContext = {
+      ...copyStyleContext(styleModel, properties.styleRef),
+      materializeParagraphFormatting: !fullyCovered,
+      effectiveTypingMarks: options?.effectiveTypingMarks
+    };
     const semanticStyleRole = portableSemanticStyleRole(styleModel, properties.styleRef);
     const semanticHeadingLevel = semanticStyleRole?.startsWith("heading-") ? Number(semanticStyleRole.slice("heading-".length)) : null;
     const parts = [];
@@ -328866,13 +328989,14 @@ function* serializeSelectionRangeSteps(context, target, includeHtml, options) {
     })), notes.diagnostics());
     plan = buildPlan(fallbackFragment, "plain-text", notes.diagnostics(), true);
   } else {
+    const sourceStyleContext = clipboardStyleContext(context);
     const hasPreservedControls = blocks.some((block) => !!block.blockSdts?.length || block.parts.some((part) => part.kind === "sdt"));
     const legacyDiagnostics = hasPreservedControls ? [...notes.diagnostics(), diagnostic("paste-no-faithful-representation", "The v2.1 clipboard flavor retains visible text but not content-control structure; use the v2.2 flavor to preserve controls.", "superdoc-v2-fragment", "warning")] : notes.diagnostics();
     const fragment4 = withPasteComments(buildFragment(grouped.map(fragmentBlockFor), legacyDiagnostics), commentsById);
     items.push({
       type: SUPERDOC_V2_CLIPBOARD_MIME,
       kind: "string",
-      data: JSON.stringify(fragment4)
+      data: JSON.stringify({ ...fragment4, sourceStyleContext })
     });
     const assets = [...rich.assetsByPartUri.values()];
     const hasRichInlineStructure = blocks.some((block) => !!block.blockSdts?.length || block.parts.some((part) => part.kind === "hyperlink" || part.kind === "image" || part.kind === "sdt"));
@@ -328885,11 +329009,12 @@ function* serializeSelectionRangeSteps(context, target, includeHtml, options) {
         assets: assets.map((asset) => asset.wire),
         diagnostics: notes.diagnostics()
       }, commentsById);
-      items.push({ type: SUPERDOC_V22_CLIPBOARD_MIME, kind: "string", data: JSON.stringify(wireFragment) });
+      items.push({ type: SUPERDOC_V22_CLIPBOARD_MIME, kind: "string", data: JSON.stringify({ ...wireFragment, sourceStyleContext }) });
       plan = buildPlan({ ...wireFragment, assets: assets.map((asset) => asset.decoded) }, "superdoc-v2-fragment", notes.diagnostics());
     } else {
       plan = buildPlan(fragment4, "superdoc-v2-fragment", notes.diagnostics());
     }
+    plan = { ...plan, sourceStyleContext };
   }
   return {
     ok: true,
@@ -329259,22 +329384,26 @@ function walkPieces(pieces, from, to, out, notes, styleContext, review) {
         const sliceEnd = Math.min(to, piece.visibleEnd) - piece.visibleStart;
         const text4 = decoded.slice(sliceStart, sliceEnd);
         if (text4.length > 0) {
-          const marks = resolveRunMarks(piece.runProperties, styleContext);
+          const characterStyleRef = styleContext?.effectiveTypingMarks ? undefined : parseCharacterStyleRef(piece.runProperties);
+          const marks = characterStyleRef ? parseNamedStyleRunMarks(piece.runProperties, styleContext) : resolveRunMarks(piece.runProperties, styleContext);
           const spanStart = piece.visibleStart + sliceStart;
           const spanEnd = piece.visibleStart + sliceEnd;
           out.push({
             kind: "run",
-            run: serializePasteRun(text4, marks, piece, spanStart, spanEnd, review)
+            run: serializePasteRun(text4, marks, piece, spanStart, spanEnd, review, characterStyleRef),
+            ...characterStyleRef ? { htmlMarks: resolveNamedStyleHtmlMarks(piece.runProperties, styleContext) } : {}
           });
         }
         break;
       }
       case "control": {
         if (piece.control === "tab" || piece.control === "symbol") {
-          const marks = resolveRunMarks(piece.runProperties, styleContext);
+          const characterStyleRef = styleContext?.effectiveTypingMarks ? undefined : parseCharacterStyleRef(piece.runProperties);
+          const marks = characterStyleRef ? parseNamedStyleRunMarks(piece.runProperties, styleContext) : resolveRunMarks(piece.runProperties, styleContext);
           out.push({
             kind: "run",
-            run: serializePasteRun(piece.symbolText ?? "\t", marks, piece, piece.visibleStart, piece.visibleEnd, review)
+            ...characterStyleRef ? { htmlMarks: resolveNamedStyleHtmlMarks(piece.runProperties, styleContext) } : {},
+            run: serializePasteRun(piece.symbolText ?? "\t", marks, piece, piece.visibleStart, piece.visibleEnd, review, characterStyleRef)
           });
         } else {
           out.push({ kind: "break" });
@@ -329335,16 +329464,21 @@ function selectionPreservesComment(markerId, from, to, review) {
     return false;
   return review.commentRanges.some((range) => range.id === markerId && range.start < to && range.end > from);
 }
-function serializePasteRun(text4, marks, piece, spanStart, spanEnd, review) {
+function serializePasteRun(text4, marks, piece, spanStart, spanEnd, review, styleRef) {
   const commentIds = resolveCommentIdsForSpan(spanStart, spanEnd, review);
   const trackedInsertion = piece.containerStack.some((scope) => scope.kind === "ins");
   return {
     text: text4,
     ...marks ? { marks } : {},
+    ...styleRef ? { styleRef } : {},
     ...commentIds.length > 0 ? { commentIds } : {},
     ...trackedInsertion ? { trackedInsertion: true } : {}
   };
 }
+function parseCharacterStyleRef(rPrXml) {
+  const value2 = parseWordRunPropertiesXml(rPrXml).styleId;
+  return value2 && value2.length > 0 ? value2 : undefined;
+}
 function resolveCommentIdsForSpan(spanStart, spanEnd, review) {
   if (!review)
     return [];
@@ -329681,6 +329815,115 @@ function parseRunPropertiesMarks(rPrXml) {
     marks.verticalAlign = verticalAlign;
   return Object.keys(marks).length > 0 ? marks : undefined;
 }
+function resolveNamedStyleHtmlMarks(rPrXml, styleContext) {
+  const marks = resolveRunMarks(rPrXml, styleContext);
+  if (!marks?.color && parseWordRunPropertiesXml(rPrXml).color?.val?.toLowerCase() === "auto") {
+    return { ...marks, color: "auto" };
+  }
+  return marks;
+}
+function parseNamedStyleRunMarks(rPrXml, styleContext) {
+  const direct = parseWordRunPropertiesXml(rPrXml);
+  const marks = {};
+  if (direct.bold !== undefined)
+    marks.bold = direct.bold === true;
+  if (direct.boldCs !== undefined)
+    marks.boldCs = direct.boldCs === true;
+  if (direct.italic !== undefined)
+    marks.italic = direct.italic === true;
+  if (direct.iCs !== undefined)
+    marks.italicCs = direct.iCs === true;
+  if (direct.textTransform !== undefined)
+    marks.caps = direct.textTransform === "uppercase";
+  if (direct.smallCaps !== undefined)
+    marks.smallCaps = direct.smallCaps === true;
+  if (direct.underline !== undefined)
+    marks.underline = direct.underline["w:val"] !== "none";
+  if (typeof direct.fontSize === "number" && direct.fontSize > 0)
+    marks.fontSizePt = direct.fontSize / 2;
+  if (typeof direct.fontSizeCs === "number" && direct.fontSizeCs > 0)
+    marks.fontSizeCsPt = direct.fontSizeCs / 2;
+  if (isPortableVerticalAlign(direct.vertAlign))
+    marks.verticalAlign = direct.vertAlign;
+  const highlight = normalizePasteHighlight(direct.highlight?.["w:val"], readHighlightFallbackShdFill(rPrXml));
+  if (highlight)
+    marks.highlight = highlight;
+  if (direct.highlight?.["w:val"]?.toLowerCase() === "none")
+    marks.highlight = "none";
+  if (direct.strike !== undefined || direct.dstrike !== undefined) {
+    const resolved = styleContext?.model.resolveRun({
+      inlineRpr: direct,
+      resolvedParagraphProperties: styleContext.paragraphProperties
+    }) ?? direct;
+    marks.strike = resolved.strike === true || resolved.dstrike === true;
+  }
+  if (rPrXml) {
+    const normalized = normalizeRunAttrsFromOoxml(direct, {
+      themeColors: styleContext?.model.themeColors,
+      themeFontScheme: styleContext?.model.themeFontScheme
+    });
+    if (!marks.color && normalized.color && /^#[0-9a-f]{6}$/i.test(normalized.color)) {
+      marks.color = normalized.color.slice(1).toUpperCase();
+    }
+    if (!marks.color && direct.color?.val?.toLowerCase() === "auto")
+      marks.color = "auto";
+    const fontProperties = direct.fontFamily && styleContext ? styleContext.model.resolveRun({ inlineRpr: direct, resolvedParagraphProperties: styleContext.paragraphProperties }) : direct;
+    const fontNormalized = normalizeRunAttrsFromOoxml(fontProperties, {
+      themeColors: styleContext?.model.themeColors,
+      themeFontScheme: styleContext?.model.themeFontScheme
+    });
+    const fontFamily = direct.fontFamily ? fontNormalized.fontFamily?.split(",")[0]?.trim().replace(/^['"]|['"]$/g, "") : undefined;
+    if (fontFamily)
+      marks.fontFamily = fontFamily;
+  }
+  if (styleContext?.materializeParagraphFormatting) {
+    const source = resolveRunMarks(rPrXml, styleContext);
+    const defaults = resolveRunMarks(rPrXml, {
+      ...styleContext,
+      paragraphProperties: styleContext.model.resolveParagraph({ inlineProps: null }),
+      styleRunProperties: {}
+    });
+    const owned = namedStyleMarkKeys(rPrXml, styleContext.model);
+    for (const key2 of Object.keys(source ?? {})) {
+      if (!owned.has(key2) || source[key2] !== defaults?.[key2])
+        Object.assign(marks, { [key2]: source[key2] });
+    }
+  }
+  return Object.keys(marks).length > 0 ? marks : undefined;
+}
+function namedStyleMarkKeys(rPrXml, model) {
+  const keys = new Set;
+  const propertiesByMark = {
+    bold: ["bold"],
+    boldCs: ["boldCs"],
+    italic: ["italic"],
+    italicCs: ["iCs"],
+    caps: ["textTransform"],
+    smallCaps: ["smallCaps"],
+    strike: ["strike", "dstrike"],
+    underline: ["underline"],
+    color: ["color"],
+    fontFamily: ["fontFamily"],
+    fontSizePt: ["fontSize"],
+    fontSizeCsPt: ["fontSizeCs"],
+    highlight: ["highlight", "shading"],
+    verticalAlign: ["vertAlign"]
+  };
+  const seen = new Set;
+  let id = parseCharacterStyleRef(rPrXml);
+  while (id && !seen.has(id)) {
+    seen.add(id);
+    const style = model.translatedLinkedStyles.styles[id];
+    if (!style)
+      break;
+    for (const mark of Object.keys(propertiesByMark)) {
+      if (propertiesByMark[mark].some((property2) => style.runProperties?.[property2] !== undefined))
+        keys.add(mark);
+    }
+    id = style.basedOn;
+  }
+  return keys;
+}
 function normalizePasteHighlight(rawHighlight, fallbackHighlight) {
   if (rawHighlight) {
     const wordHighlight = normalizeWordHighlightValue(rawHighlight);
@@ -329971,7 +330214,14 @@ function serializedLeafPartInline(part) {
     return part.image;
   if (part.kind === "break")
     return { kind: "lineBreak" };
-  return { kind: "text", text: part.run.text, ...part.run.marks ? { marks: part.run.marks } : {}, ...part.run.commentIds ? { commentIds: part.run.commentIds } : {}, ...part.run.trackedInsertion ? { trackedInsertion: true } : {} };
+  return {
+    kind: "text",
+    text: part.run.text,
+    ...part.run.marks ? { marks: part.run.marks } : {},
+    ...part.run.styleRef ? { styleRef: part.run.styleRef } : {},
+    ...part.run.commentIds ? { commentIds: part.run.commentIds } : {},
+    ...part.run.trackedInsertion ? { trackedInsertion: true } : {}
+  };
 }
 function fragmentBlockFor(grouped) {
   if (grouped.kind === "paragraph")
@@ -330043,8 +330293,9 @@ function blockInlineHtml(block, assets, defaultTextColor) {
 function renderHtmlPart(part, assets, defaultTextColor) {
   if (part.kind === "break")
     return "<br/>";
-  if (part.kind === "run")
-    return renderHtmlRun(part.run, defaultTextColor);
+  if (part.kind === "run") {
+    return renderHtmlRun(part.htmlMarks ? { ...part.run, marks: part.htmlMarks } : part.run, defaultTextColor);
+  }
   if (part.kind === "image") {
     const asset = assets.get(part.image.assetId);
     if (!asset)
@@ -330214,7 +330465,7 @@ function renderHtmlRun(run, defaultTextColor) {
   const styles = [];
   const color2 = marks.color ?? defaultTextColor;
   if (color2)
-    styles.push(`color: #${color2}`);
+    styles.push(color2 === "auto" ? "color: initial" : `color: #${color2}`);
   if (marks.fontSizePt)
     styles.push(`font-size: ${marks.fontSizePt}pt`);
   if (marks.fontFamily)
@@ -330257,6 +330508,7 @@ var init_serialize = __esm(() => {
   init_common();
   init_paragraph_property_order();
   init_contracts();
+  init_style_context();
   init_public_model();
   init_hyperlink_values();
   init_footnote_range();
@@ -334407,7 +334659,7 @@ class V2SelectionMutationAdapter {
           start: { kind: "text", blockId: plan.startBlockId, offset: from },
           end: { kind: "text", blockId: plan.startBlockId, offset: from + 1 },
           ...storyLocator ? { story: storyLocator } : {}
-        }, false, { offsetSpace: "kernel" });
+        }, false, { offsetSpace: "kernel", effectiveTypingMarks: true });
         if (!source.ok)
           return failureWithoutResolution(source.code, source.message);
         const block = source.result.plan?.fragment.blocks[0];
@@ -403160,6 +403412,9 @@ class V2ClipboardAdapter {
   }
   insert(input, options) {
     const planned = resolveInsertPlan(input);
+    return this.insertPrepared(input, options, planned);
+  }
+  insertPrepared(input, options, planned) {
     if (!planned.ok) {
       if (input.payload)
         return failureFromParse(this.parse(input.payload, { fallback: input.fallback }));
@@ -403191,6 +403446,27 @@ class V2ClipboardAdapter {
       formattingMode: planned.plan.summary.sourceKind === "plain-text" ? "match-destination" : input.formattingMode ?? "preserve-source",
       fragment: planned.applyPlan
     };
+    if (input.plan && planned.plan.sourceStyleContext !== undefined && operation.formattingMode === "preserve-source" && hasNamedCharacterStyles(planned.plan.fragment.blocks) && !clipboardStyleContextMatches(this.context, planned.plan.sourceStyleContext)) {
+      return failure25(publicFailureCodeForPasteReason("paste-no-faithful-representation"), "The generated native plan has incompatible source styles; insert the original payload for portable recovery.", "paste-no-faithful-representation");
+    }
+    if (input.payload && !input.plan && operation.formattingMode === "preserve-source" && planned.plan.summary.sourceKind === "superdoc-v2-fragment" && hasNamedCharacterStyles(planned.plan.fragment.blocks)) {
+      const preflight = preflightSDDocumentSessionInternalFragmentApply(this.context.session, operation);
+      const missingStyles = !preflight.ok && preflight.reason === "style-reference-not-found";
+      const conflictingContext = preflight.ok && !clipboardStyleContextMatches(this.context, planned.plan.sourceStyleContext);
+      if (missingStyles || conflictingContext) {
+        if (planned.plan.fragment.comments?.length || hasNativeReviewOrControls(planned.plan.fragment.blocks)) {
+          return failure25(publicFailureCodeForPasteReason("paste-no-faithful-representation"), "Portable style recovery would discard comments, tracked insertions, or content controls.", "paste-no-faithful-representation", planned.plan.diagnostics);
+        }
+        const portable = createPortableHtmlInsertPlan(input.payload, { fallback: input.fallback });
+        if (portable.ok) {
+          const warning = diagnostic("paste-no-faithful-representation", "Source style definitions are unavailable or differ; the portable HTML appearance was used.", "html", "warning");
+          return this.insertPrepared({ ...input, payload: undefined, fragment: undefined, plan: undefined }, options, { ...portable, plan: { ...portable.plan, diagnostics: [...planned.plan.diagnostics, ...portable.plan.diagnostics, warning] } });
+        }
+        if (conflictingContext) {
+          return failure25(publicFailureCodeForPasteReason(portable.reason), portable.diagnostics[0]?.message ?? portable.reason, portable.reason, portable.diagnostics);
+        }
+      }
+    }
     if (options?.dryRun) {
       const preflight = preflightSDDocumentSessionInternalFragmentApply(this.context.session, operation);
       if (!preflight.ok) {
@@ -403321,6 +403597,34 @@ class V2ClipboardAdapter {
     return attachMutationPublicRevision(serialized.result, this.context.currentPublicRevision());
   }
 }
+function hasNamedCharacterStyles(blocks) {
+  return blocks.some((block) => {
+    if (block.kind === "table") {
+      return block.rows.some((row) => row.cells.some((cell) => hasNamedCharacterStyles(cell.blocks)));
+    }
+    if (block.kind !== "paragraph" && block.kind !== "heading")
+      return false;
+    return block.runs.some((run) => !!run.styleRef) || inlinesHaveNamedCharacterStyles(block.inlines ?? []);
+  });
+}
+function hasNativeReviewOrControls(blocks) {
+  return blocks.some((block) => {
+    if ("blockSdts" in block && block.blockSdts?.length)
+      return true;
+    if (block.kind === "table") {
+      return block.rows.some((row) => row.cells.some((cell) => hasNativeReviewOrControls(cell.blocks)));
+    }
+    if (block.kind !== "paragraph" && block.kind !== "heading")
+      return false;
+    return block.runs.some((run) => run.commentIds?.length || run.trackedInsertion) || inlinesHaveNativeReviewOrControls(block.inlines ?? []);
+  });
+}
+function inlinesHaveNativeReviewOrControls(inlines) {
+  return inlines.some((inline) => inline.kind === "sdt" || (inline.kind === "text" ? !!inline.commentIds?.length || inline.trackedInsertion === true : inline.kind === "hyperlink" && inlinesHaveNativeReviewOrControls(inline.inlines)));
+}
+function inlinesHaveNamedCharacterStyles(inlines) {
+  return inlines.some((inline) => inline.kind === "text" ? !!inline.styleRef : (inline.kind === "hyperlink" || inline.kind === "sdt") && inlinesHaveNamedCharacterStyles(inline.inlines));
+}
 function captureClipboardReadState(context) {
   return {
     source: getSDDocumentSessionInternalSourceCommit(context.session),
@@ -403491,7 +403795,8 @@ function resolveInsertPlan(input) {
     const prepared = prepareClipboardPlan(normalized.fragment, input.plan.summary.sourceKind, input.plan.diagnostics, input.plan.summary.plainFallback);
     return {
       ok: true,
-      ...prepared
+      ...prepared,
+      plan: { ...prepared.plan, ...input.plan.sourceStyleContext !== undefined ? { sourceStyleContext: input.plan.sourceStyleContext } : {} }
     };
   }
   if (input.payload) {
@@ -403771,6 +404076,8 @@ var init_adapter37 = __esm(() => {
   init_adapter7();
   init_contracts();
   init_parse5();
+  init_plan3();
+  init_style_context();
   init_parse_v2_fragment();
   init_serialize();
   CLIPBOARD_TD = new TextDecoder;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/mcp",
-  "version": "1.7.0-next.14",
+  "version": "1.7.0-next.16",
   "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.14",
+    "@superdoc/sdk": "2.20.0-next.16",
     "debug": "^4.4.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "superdoc": "2.23.0-next.14",
-    "@superdoc/docx-engine": "0.22.0-next.14",
+    "superdoc": "2.23.0-next.16",
+    "@superdoc/docx-engine": "0.22.0-next.16",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",