@superdoc-dev/cli 0.16.0-next.2 → 0.16.0-next.4

package/dist/index.js

@@ -68110,7 +68110,7 @@ var init_remark_gfm_BhnWr3yf_es = __esm(() => {
   emptyOptions2 = {};
 });
 
-// ../../packages/superdoc/dist/chunks/SuperConverter-B-oz3OyP.es.js
+// ../../packages/superdoc/dist/chunks/SuperConverter-nmIRMGtB.es.js
 function getExtensionConfigField(extension$1, field, context = { name: "" }) {
   const fieldValue = extension$1.config[field];
   if (typeof fieldValue === "function")
@@ -68913,10 +68913,10 @@ function isStoryLocator2(value) {
     case "headerFooterSlot":
       return isSectionAddress2(value.section) && isStringEnumMember2(value.headerFooterKind, STORY_HEADER_FOOTER_KINDS2) && isStringEnumMember2(value.variant, STORY_HEADER_FOOTER_VARIANTS2) && isOptionalStringEnumMember2(value.resolution, STORY_HEADER_FOOTER_RESOLUTIONS2) && isOptionalStringEnumMember2(value.onWrite, STORY_HEADER_FOOTER_ON_WRITE_VALUES2);
     case "headerFooterPart":
-      return isNonEmptyString$1(value.refId);
+      return isNonEmptyString$2(value.refId);
     case "footnote":
     case "endnote":
-      return isNonEmptyString$1(value.noteId);
+      return isNonEmptyString$2(value.noteId);
   }
 }
 function getStoryHeaderFooterResolution(locator) {
@@ -68949,7 +68949,7 @@ function storyLocatorToKey2(locator) {
 function isObjectRecord$1(value) {
   return typeof value === "object" && value !== null;
 }
-function isNonEmptyString$1(value) {
+function isNonEmptyString$2(value) {
   return typeof value === "string" && value.length > 0;
 }
 function isStringEnumMember2(value, allowed) {
@@ -80590,6 +80590,7 @@ function handleStructuredContentNode(params3) {
     return null;
   const paragraph2 = sdtContent.elements?.find((el) => el.name === "w:p");
   const table = sdtContent.elements?.find((el) => el.name === "w:tbl");
+  const blockField = sdtContent.elements?.find((el) => BLOCK_FIELD_XML_NAMES.has(el?.name));
   const { marks } = parseAnnotationMarks(sdtContent);
   const translatedContent = nodeListHandler.handler({
     ...params3,
@@ -80597,7 +80598,7 @@ function handleStructuredContentNode(params3) {
     path: [...params3.path || [], sdtContent]
   });
   return {
-    type: paragraph2 || table ? "structuredContentBlock" : "structuredContent",
+    type: paragraph2 || table || blockField ? "structuredContentBlock" : "structuredContent",
     content: translatedContent,
     marks,
     attrs: {
@@ -82409,17 +82410,52 @@ function preProcessTocInstruction(nodesToCombine, instrText) {
     elements: nodesToCombine
   }];
 }
-function preProcessIndexInstruction(nodesToCombine, instrText, _docx, instructionTokens = null) {
+function normalizeFieldContentToParagraphs(nodes) {
+  const input = Array.isArray(nodes) ? nodes : [];
+  if (input.length === 0)
+    return [{
+      name: "w:p",
+      type: "element",
+      elements: []
+    }];
+  const out = [];
+  let buffer3 = null;
+  const flushBuffer = () => {
+    if (buffer3) {
+      out.push({
+        name: "w:p",
+        type: "element",
+        elements: buffer3
+      });
+      buffer3 = null;
+    }
+  };
+  for (const node3 of input)
+    if (node3?.name === "w:p") {
+      flushBuffer();
+      out.push(node3);
+    } else {
+      if (!buffer3)
+        buffer3 = [];
+      buffer3.push(node3);
+    }
+  flushBuffer();
+  return out;
+}
+function buildBlockFieldNode(xmlName, nodesToCombine, instrText, instructionTokens = null) {
   return [{
-    name: "sd:index",
+    name: xmlName,
     type: "element",
     attributes: {
       instruction: instrText,
       ...instructionTokens ? { instructionTokens } : {}
     },
-    elements: nodesToCombine
+    elements: normalizeFieldContentToParagraphs(nodesToCombine)
   }];
 }
+function preProcessIndexInstruction(nodesToCombine, instrText, _docx, instructionTokens = null) {
+  return buildBlockFieldNode("sd:index", nodesToCombine, instrText, instructionTokens);
+}
 function preProcessXeInstruction(nodesToCombine, instrText, _docx, instructionTokens = null) {
   return [{
     name: "sd:indexEntry",
@@ -82497,18 +82533,8 @@ function preProcessCitationInstruction(nodesToCombine, instrText, _docx, instruc
     elements: nodesToCombine
   }];
 }
-function preProcessBibliographyInstruction(nodesToCombine, instrText) {
-  const contentNodes = Array.isArray(nodesToCombine) && nodesToCombine.length > 0 ? nodesToCombine : [{
-    name: "w:p",
-    type: "element",
-    elements: []
-  }];
-  return [{
-    name: "sd:bibliography",
-    type: "element",
-    attributes: { instruction: instrText },
-    elements: contentNodes
-  }];
+function preProcessBibliographyInstruction(nodesToCombine, instrText, _docx, instructionTokens = null) {
+  return buildBlockFieldNode("sd:bibliography", nodesToCombine, instrText, instructionTokens);
 }
 function preProcessTaInstruction(nodesToCombine, instrText, _docx, instructionTokens = null) {
   return [{
@@ -82522,15 +82548,7 @@ function preProcessTaInstruction(nodesToCombine, instrText, _docx, instructionTo
   }];
 }
 function preProcessToaInstruction(nodesToCombine, instrText, _docx, instructionTokens = null) {
-  return [{
-    name: "sd:tableOfAuthorities",
-    type: "element",
-    attributes: {
-      instruction: instrText,
-      ...instructionTokens ? { instructionTokens } : {}
-    },
-    elements: nodesToCombine
-  }];
+  return buildBlockFieldNode("sd:tableOfAuthorities", nodesToCombine, instrText, instructionTokens);
 }
 function preProcessDocumentStatInstruction(nodesToCombine, instrText, _docxOrFieldRunRPr = null, instructionTokensOrFieldRunRPr = null, fieldRunRPr = null) {
   const effectiveFieldRunRPr = fieldRunRPr ?? (instructionTokensOrFieldRunRPr?.name === "w:rPr" ? instructionTokensOrFieldRunRPr : null) ?? (_docxOrFieldRunRPr?.name === "w:rPr" ? _docxOrFieldRunRPr : null);
@@ -97883,6 +97901,69 @@ function buildFieldResultRuns(params3, outputMarks) {
     }]
   }];
 }
+function wrapParagraphsAsComplexField(contentNodes, instructionElements, wrapperParagraphProperties = null) {
+  const beginElements = [
+    {
+      name: "w:r",
+      elements: [{
+        name: "w:fldChar",
+        attributes: { "w:fldCharType": "begin" },
+        elements: []
+      }]
+    },
+    {
+      name: "w:r",
+      elements: instructionElements
+    },
+    {
+      name: "w:r",
+      elements: [{
+        name: "w:fldChar",
+        attributes: { "w:fldCharType": "separate" },
+        elements: []
+      }]
+    }
+  ];
+  if (contentNodes.length > 0) {
+    const firstParagraph = contentNodes[0];
+    if (wrapperParagraphProperties) {
+      const restoredPPr = carbonCopy(wrapperParagraphProperties);
+      if (firstParagraph.elements) {
+        const pPrIndex = firstParagraph.elements.findIndex((el) => el.name === "w:pPr");
+        if (pPrIndex >= 0)
+          firstParagraph.elements.splice(pPrIndex, 1, restoredPPr);
+        else
+          firstParagraph.elements.unshift(restoredPPr);
+      } else
+        firstParagraph.elements = [restoredPPr];
+    }
+    let insertIndex = 0;
+    if (firstParagraph.elements) {
+      const pPrIndex = firstParagraph.elements.findIndex((el) => el.name === "w:pPr");
+      insertIndex = pPrIndex >= 0 ? pPrIndex + 1 : 0;
+    } else
+      firstParagraph.elements = [];
+    firstParagraph.elements.splice(insertIndex, 0, ...beginElements);
+  } else
+    contentNodes.push({
+      name: "w:p",
+      elements: beginElements
+    });
+  const endElements = [{
+    name: "w:r",
+    elements: [{
+      name: "w:fldChar",
+      attributes: { "w:fldCharType": "end" },
+      elements: []
+    }]
+  }];
+  const lastParagraph = contentNodes[contentNodes.length - 1];
+  if (lastParagraph.elements)
+    lastParagraph.elements.push(...endElements);
+  else
+    lastParagraph.elements = [...endElements];
+  return contentNodes;
+}
 function parseTarget(instruction) {
   if (!instruction)
     return "";
@@ -102488,8 +102569,8 @@ function handleTableOfContentsNode(node3, context) {
     recordBlockKind: context.recordBlockKind
   });
 }
-function handleIndexNode(node3, context) {
-  const children = getIndexChildren(node3);
+function handleParagraphContainerNode(node3, context) {
+  const children = getParagraphContainerChildren(node3);
   if (children.length === 0)
     return;
   const { blocks, recordBlockKind, nextBlockId, positions, trackedChangesConfig, bookmarks, hyperlinkConfig, sectionState, converters: converters$1, themeColors, enableComments } = context;
@@ -102693,7 +102774,7 @@ function handleStructuredContentBlockNode(node3, context) {
       }
       return;
     }
-    if (child.type === "documentPartObject" && Array.isArray(child.content))
+    if (Array.isArray(child.content) && (child.type === "documentPartObject" || child.type === "bibliography" || child.type === "index" || child.type === "tableOfAuthorities"))
       child.content.forEach(visitChild);
   };
   node3.content.forEach(visitChild);
@@ -102944,83 +103025,12 @@ function handleDocumentPartObjectNode(node3, context) {
           recordBlockKind
         };
         processTocChildren(child.content, metadata, tocContext, output);
-      }
+      } else if (PARAGRAPH_CONTAINER_TYPES.has(child.type))
+        handleParagraphContainerNode(child, context);
+      else if (child.type === "structuredContentBlock")
+        handleStructuredContentBlockNode(child, context);
   }
 }
-function handleBibliographyNode(node3, context) {
-  const children = getChildren$1(node3);
-  if (children.length === 0)
-    return;
-  const { blocks, recordBlockKind, nextBlockId, positions, trackedChangesConfig, bookmarks, hyperlinkConfig, sectionState, converters: converters$1, themeColors, enableComments } = context;
-  const paragraphToFlowBlocks$1 = converters$1.paragraphToFlowBlocks;
-  children.forEach((child) => {
-    if (child.type !== "paragraph")
-      return;
-    if ((sectionState?.ranges?.length ?? 0) > 0) {
-      const nextSection = sectionState.ranges[sectionState.currentSectionIndex + 1];
-      if (nextSection && sectionState.currentParagraphIndex === nextSection.startParagraphIndex) {
-        const currentSection = sectionState.ranges[sectionState.currentSectionIndex];
-        const sectionBreak = createSectionBreakBlock(nextSection, nextBlockId, shouldRequirePageBoundary(currentSection, nextSection) || hasIntrinsicBoundarySignals(nextSection) ? { requirePageBoundary: true } : undefined);
-        blocks.push(sectionBreak);
-        recordBlockKind?.(sectionBreak.kind);
-        sectionState.currentSectionIndex++;
-      }
-    }
-    paragraphToFlowBlocks$1({
-      para: child,
-      nextBlockId,
-      positions,
-      trackedChangesConfig,
-      bookmarks,
-      hyperlinkConfig,
-      themeColors,
-      converterContext: context.converterContext,
-      enableComments,
-      converters: converters$1
-    }).forEach((block) => {
-      blocks.push(block);
-      recordBlockKind?.(block.kind);
-    });
-    sectionState.currentParagraphIndex++;
-  });
-}
-function handleTableOfAuthoritiesNode(node3, context) {
-  const children = getChildren(node3);
-  if (children.length === 0)
-    return;
-  const { blocks, recordBlockKind, nextBlockId, positions, trackedChangesConfig, bookmarks, hyperlinkConfig, sectionState, converters: converters$1, themeColors, enableComments } = context;
-  const paragraphToFlowBlocks$1 = converters$1.paragraphToFlowBlocks;
-  children.forEach((child) => {
-    if (child.type !== "paragraph")
-      return;
-    if ((sectionState?.ranges?.length ?? 0) > 0) {
-      const nextSection = sectionState.ranges[sectionState.currentSectionIndex + 1];
-      if (nextSection && sectionState.currentParagraphIndex === nextSection.startParagraphIndex) {
-        const currentSection = sectionState.ranges[sectionState.currentSectionIndex];
-        const sectionBreak = createSectionBreakBlock(nextSection, nextBlockId, shouldRequirePageBoundary(currentSection, nextSection) || hasIntrinsicBoundarySignals(nextSection) ? { requirePageBoundary: true } : undefined);
-        blocks.push(sectionBreak);
-        recordBlockKind?.(sectionBreak.kind);
-        sectionState.currentSectionIndex++;
-      }
-    }
-    paragraphToFlowBlocks$1({
-      para: child,
-      nextBlockId,
-      positions,
-      trackedChangesConfig,
-      bookmarks,
-      hyperlinkConfig,
-      themeColors,
-      converterContext: context.converterContext,
-      enableComments,
-      converters: converters$1
-    }).forEach((block) => {
-      blocks.push(block);
-      recordBlockKind?.(block.kind);
-    });
-    sectionState.currentParagraphIndex++;
-  });
-}
 function structuredContentNodeToBlocks({ node: node3, positions, defaultFont, defaultSize, inheritedMarks, sdtMetadata, visitNode, runProperties, inlineRunProperties, converterContext }) {
   const inlineMetadata = resolveNodeSdtMetadata(node3, "structuredContent");
   const nextSdt = inlineMetadata ?? sdtMetadata;
@@ -104698,6 +104708,7 @@ function toFlowBlocks(pmDoc, options) {
     bookmarks: bookmarks.size
   });
   const mergedBlocks = mergeFusedParagraphs(mergeDropCapParagraphs(hydrateImageBlocks(blocks, options?.mediaFiles)));
+  stampTrackedChangeColors(mergedBlocks, options?.resolveTrackedChangeColor);
   flowBlockCache?.commit();
   return {
     blocks: mergedBlocks,
@@ -108705,6 +108716,9 @@ function getTextAdapter(editor, input) {
 `, `
 `, { textModel: "visible" });
 }
+function rangesOverlap(a, b) {
+  return a[0] < b[1] && b[0] < a[1];
+}
 function getRawTrackedMarks(editor) {
   try {
     const marks = getTrackChanges(editor.state);
@@ -108904,6 +108918,7 @@ function groupTrackedChanges(editor) {
     const wordRevisionId = toNonEmptyString(attrs.sourceId);
     const wordRevisionIdKey = getWordRevisionIdKey(markType);
     const excerptText = !wordRevisionId || !hasChildTrackedMarkOnNode(item, id2) ? getTrackedMarkText(editor, item) : "";
+    const range = [item.from, item.to];
     if (!existing) {
       byRawId.set(groupKey, {
         rawId: groupKey,
@@ -108915,6 +108930,7 @@ function groupTrackedChanges(editor) {
         hasFormat: nextHasFormat,
         attrs: { ...attrs },
         excerptParts: excerptText ? [excerptText] : [],
+        excerptRanges: excerptText ? [range] : [],
         wordRevisionIds: wordRevisionIdKey ? mergeWordRevisionId(undefined, wordRevisionIdKey, wordRevisionId ?? undefined) : undefined
       });
       continue;
@@ -108926,12 +108942,14 @@ function groupTrackedChanges(editor) {
     existing.hasFormat = existing.hasFormat || nextHasFormat;
     if (Object.keys(existing.attrs).length === 0 && Object.keys(attrs).length > 0)
       existing.attrs = { ...attrs };
-    if (excerptText)
+    if (excerptText && !existing.excerptRanges.some((counted) => rangesOverlap(counted, range))) {
+      existing.excerptRanges.push(range);
       existing.excerptParts.push(excerptText);
+    }
     if (wordRevisionIdKey)
       existing.wordRevisionIds = mergeWordRevisionId(existing.wordRevisionIds, wordRevisionIdKey, wordRevisionId ?? undefined);
   }
-  const grouped = Array.from(byRawId.values()).map(({ excerptParts, ...change }) => {
+  const grouped = Array.from(byRawId.values()).map(({ excerptParts, excerptRanges: _excerptRanges, ...change }) => {
     const hasWordSourceId = Boolean(toNonEmptyString(change.attrs.sourceId));
     const rawExcerpt = excerptParts.join("");
     const withExcerpt = {
@@ -112811,6 +112829,50 @@ var isRegExp = (value) => {
     partialRow: fragment2.kind === "table" ? fragment2.partialRow : undefined,
     sourceAnchor: fragment2.sourceAnchor ?? existing?.sourceAnchor
   });
+}, isNonEmptyString$1 = (value) => typeof value === "string" && value.length > 0, authorFromTrackedChangeMeta = (meta) => ({
+  name: meta.author,
+  email: meta.authorEmail,
+  image: meta.authorImage
+}), applyColorToLayer = (meta, resolve2) => {
+  const color2 = resolve2?.(authorFromTrackedChangeMeta(meta));
+  if (isNonEmptyString$1(color2)) {
+    meta.color = color2;
+    return;
+  }
+  delete meta.color;
+}, stampRunTrackedChangeColors = (run$1, resolve2) => {
+  if (Array.isArray(run$1.trackedChanges))
+    for (const layer of run$1.trackedChanges)
+      applyColorToLayer(layer, resolve2);
+  if (run$1.trackedChange)
+    applyColorToLayer(run$1.trackedChange, resolve2);
+}, stampBlockTrackedChangeColors = (block, resolve2) => {
+  if (!block)
+    return;
+  switch (block.kind) {
+    case "paragraph":
+      for (const run$1 of block.runs)
+        stampRunTrackedChangeColors(run$1, resolve2);
+      break;
+    case "list":
+      for (const item of block.items)
+        stampBlockTrackedChangeColors(item.paragraph, resolve2);
+      break;
+    case "table":
+      for (const row of block.rows)
+        for (const cell of row.cells) {
+          stampBlockTrackedChangeColors(cell.paragraph, resolve2);
+          if (Array.isArray(cell.blocks))
+            for (const nested of cell.blocks)
+              stampBlockTrackedChangeColors(nested, resolve2);
+        }
+      break;
+    default:
+      break;
+  }
+}, stampTrackedChangeColors = (blocks, resolve2) => {
+  for (const block of blocks)
+    stampBlockTrackedChangeColors(block, resolve2);
 }, idlessSdtContainerKeys, nextIdlessSdtContainerKey = 0, engines_exports, EMPTY_SDT_PLACEHOLDER_TEXT = "Click or tap here to enter text", FONT_SLOT_THEME_PAIRS, TABLE_STYLE_ID_TABLE_GRID = "TableGrid", TABLE_FALLBACK_BORDER, TABLE_FALLBACK_BORDERS, TABLE_FALLBACK_CELL_PADDING, DEFAULT_TBL_LOOK, CNF_STYLE_MAP, TABLE_STYLE_PRECEDENCE, getToCssFontFamily = () => {
   return SuperConverter.toCssFontFamily;
 }, getSpacingStyle = (spacing, isListItem$1) => {
@@ -114045,7 +114107,7 @@ var isRegExp = (value) => {
       normalized.push(node3);
   });
   return normalized;
-}, lower16 = 65535, factor16, DEL_BEFORE = 1, DEL_AFTER = 2, DEL_ACROSS = 4, DEL_SIDE = 8, MapResult = class {
+}, BLOCK_FIELD_XML_NAMES, lower16 = 65535, factor16, DEL_BEFORE = 1, DEL_AFTER = 2, DEL_ACROSS = 4, DEL_SIDE = 8, MapResult = class {
   constructor(pos, delInfo, recover) {
     this.pos = pos;
     this.delInfo = delInfo;
@@ -118583,7 +118645,7 @@ var isRegExp = (value) => {
           currentField.instructionTokens.push(...instructionTokens);
           const instrTextValue = instrTextEl?.elements?.[0]?.text;
           if (instrTextValue != null)
-            currentField.instrText += `${instrTextValue} `;
+            currentField.instrText += `${instrTextValue}`;
           if (instructionTokens.some((token) => token.type === "tab"))
             currentField.instrText += "\t";
           return;
@@ -124303,66 +124365,19 @@ var isRegExp = (value) => {
   });
   return {
     type: SD_NODE_NAME$14,
-    attrs: { instruction: node3.attributes?.instruction || "" },
+    attrs: {
+      instruction: node3.attributes?.instruction || "",
+      instructionTokens: node3.attributes?.instructionTokens || null,
+      wrapperParagraphProperties: node3.attributes?.wrapperParagraphProperties || null
+    },
     content: processedContent
   };
 }, decode$18 = (params3) => {
   const { node: node3 } = params3;
-  const contentNodes = (node3.content ?? []).map((n) => exportSchemaToJson({
+  return wrapParagraphsAsComplexField((node3.content ?? []).map((n) => exportSchemaToJson({
     ...params3,
     node: n
-  }));
-  const instructionElements = buildInstructionElements(node3.attrs?.instruction, null);
-  const beginElements = [
-    {
-      name: "w:r",
-      elements: [{
-        name: "w:fldChar",
-        attributes: { "w:fldCharType": "begin" },
-        elements: []
-      }]
-    },
-    {
-      name: "w:r",
-      elements: instructionElements
-    },
-    {
-      name: "w:r",
-      elements: [{
-        name: "w:fldChar",
-        attributes: { "w:fldCharType": "separate" },
-        elements: []
-      }]
-    }
-  ];
-  if (contentNodes.length > 0) {
-    const firstParagraph = contentNodes[0];
-    let insertIndex = 0;
-    if (firstParagraph.elements) {
-      const pPrIndex = firstParagraph.elements.findIndex((el) => el.name === "w:pPr");
-      insertIndex = pPrIndex >= 0 ? pPrIndex + 1 : 0;
-    } else
-      firstParagraph.elements = [];
-    firstParagraph.elements.splice(insertIndex, 0, ...beginElements);
-  } else
-    contentNodes.push({
-      name: "w:p",
-      elements: beginElements
-    });
-  const endElements = [{
-    name: "w:r",
-    elements: [{
-      name: "w:fldChar",
-      attributes: { "w:fldCharType": "end" },
-      elements: []
-    }]
-  }];
-  const lastParagraph = contentNodes[contentNodes.length - 1];
-  if (lastParagraph.elements)
-    lastParagraph.elements.push(...endElements);
-  else
-    lastParagraph.elements = [...endElements];
-  return contentNodes;
+  })), buildInstructionElements(node3.attrs?.instruction, node3.attrs?.instructionTokens ?? null), node3.attrs?.wrapperParagraphProperties ?? null);
 }, config$15, translator$20, XML_NODE_NAME$13 = "sd:authorityEntry", SD_NODE_NAME$13 = "authorityEntry", encode$17 = (params3) => {
   const { nodes = [], nodeListHandler } = params3 || {};
   const node3 = nodes[0];
@@ -124445,67 +124460,17 @@ var isRegExp = (value) => {
     type: SD_NODE_NAME$12,
     attrs: {
       instruction: node3.attributes?.instruction || "",
-      instructionTokens: node3.attributes?.instructionTokens || null
+      instructionTokens: node3.attributes?.instructionTokens || null,
+      wrapperParagraphProperties: node3.attributes?.wrapperParagraphProperties || null
     },
     content: processedContent
   };
 }, decode$16 = (params3) => {
   const { node: node3 } = params3;
-  const contentNodes = (node3.content ?? []).map((n) => exportSchemaToJson({
+  return wrapParagraphsAsComplexField((node3.content ?? []).map((n) => exportSchemaToJson({
     ...params3,
     node: n
-  }));
-  const instructionElements = buildInstructionElements(node3.attrs?.instruction, node3.attrs?.instructionTokens);
-  const beginElements = [
-    {
-      name: "w:r",
-      elements: [{
-        name: "w:fldChar",
-        attributes: { "w:fldCharType": "begin" },
-        elements: []
-      }]
-    },
-    {
-      name: "w:r",
-      elements: instructionElements
-    },
-    {
-      name: "w:r",
-      elements: [{
-        name: "w:fldChar",
-        attributes: { "w:fldCharType": "separate" },
-        elements: []
-      }]
-    }
-  ];
-  if (contentNodes.length > 0) {
-    const firstParagraph = contentNodes[0];
-    let insertIndex = 0;
-    if (firstParagraph.elements) {
-      const pPrIndex = firstParagraph.elements.findIndex((el) => el.name === "w:pPr");
-      insertIndex = pPrIndex >= 0 ? pPrIndex + 1 : 0;
-    } else
-      firstParagraph.elements = [];
-    firstParagraph.elements.splice(insertIndex, 0, ...beginElements);
-  } else
-    contentNodes.push({
-      name: "w:p",
-      elements: beginElements
-    });
-  const endElements = [{
-    name: "w:r",
-    elements: [{
-      name: "w:fldChar",
-      attributes: { "w:fldCharType": "end" },
-      elements: []
-    }]
-  }];
-  const lastParagraph = contentNodes[contentNodes.length - 1];
-  if (lastParagraph.elements)
-    lastParagraph.elements.push(...endElements);
-  else
-    lastParagraph.elements = [...endElements];
-  return contentNodes;
+  })), buildInstructionElements(node3.attrs?.instruction, node3.attrs?.instructionTokens), node3.attrs?.wrapperParagraphProperties ?? null);
 }, config$13, translator$22, XML_NODE_NAME$11 = "sd:sequenceField", SD_NODE_NAME$11 = "sequenceField", encode$15 = (params3) => {
   const { nodes = [], nodeListHandler } = params3 || {};
   const node3 = nodes[0];
@@ -124678,67 +124643,17 @@ var isRegExp = (value) => {
     type: "index",
     attrs: {
       instruction: node3.attributes?.instruction || "",
-      instructionTokens: node3.attributes?.instructionTokens || null
+      instructionTokens: node3.attributes?.instructionTokens || null,
+      wrapperParagraphProperties: node3.attributes?.wrapperParagraphProperties || null
     },
     content: processedContent
   };
 }, decode$13 = (params3) => {
   const { node: node3 } = params3;
-  const contentNodes = (node3.content ?? []).map((n) => exportSchemaToJson({
+  return wrapParagraphsAsComplexField((node3.content ?? []).map((n) => exportSchemaToJson({
     ...params3,
     node: n
-  }));
-  const instructionElements = buildInstructionElements(node3.attrs?.instruction, node3.attrs?.instructionTokens);
-  const indexBeginElements = [
-    {
-      name: "w:r",
-      elements: [{
-        name: "w:fldChar",
-        attributes: { "w:fldCharType": "begin" },
-        elements: []
-      }]
-    },
-    {
-      name: "w:r",
-      elements: instructionElements
-    },
-    {
-      name: "w:r",
-      elements: [{
-        name: "w:fldChar",
-        attributes: { "w:fldCharType": "separate" },
-        elements: []
-      }]
-    }
-  ];
-  if (contentNodes.length > 0) {
-    const firstParagraph = contentNodes[0];
-    let insertIndex = 0;
-    if (firstParagraph.elements) {
-      const pPrIndex = firstParagraph.elements.findIndex((el) => el.name === "w:pPr");
-      insertIndex = pPrIndex >= 0 ? pPrIndex + 1 : 0;
-    } else
-      firstParagraph.elements = [];
-    firstParagraph.elements.splice(insertIndex, 0, ...indexBeginElements);
-  } else
-    contentNodes.push({
-      name: "w:p",
-      elements: indexBeginElements
-    });
-  const indexEndElements = [{
-    name: "w:r",
-    elements: [{
-      name: "w:fldChar",
-      attributes: { "w:fldCharType": "end" },
-      elements: []
-    }]
-  }];
-  const lastParagraph = contentNodes[contentNodes.length - 1];
-  if (lastParagraph.elements)
-    lastParagraph.elements.push(...indexEndElements);
-  else
-    lastParagraph.elements = [...indexEndElements];
-  return contentNodes;
+  })), buildInstructionElements(node3.attrs?.instruction, node3.attrs?.instructionTokens), node3.attrs?.wrapperParagraphProperties ?? null);
 }, config$10, translator$25, XML_NODE_NAME$8 = "sd:indexEntry", SD_NODE_NAME$8 = "indexEntry", encode$12 = (params3) => {
   const { nodes = [], nodeListHandler } = params3 || {};
   const node3 = nodes[0];
@@ -125062,13 +124977,47 @@ var isRegExp = (value) => {
     nodes: [resultNode],
     consumed: 1
   };
-}, textNodeHandlerEntity, PARAGRAPH_PROPERTIES_XML_NAME = "w:pPr", BLOCK_FIELD_XML_NAMES, hasMeaningfulParagraphContent = (elements = []) => elements.some((element) => element?.name && element.name !== PARAGRAPH_PROPERTIES_XML_NAME), hoistBlockFieldNodes = (params3, paragraphNode) => {
+}, textNodeHandlerEntity, PARAGRAPH_PROPERTIES_XML_NAME = "w:pPr", hasMeaningfulParagraphContent = (elements = []) => elements.some((element) => element?.name && element.name !== PARAGRAPH_PROPERTIES_XML_NAME), findParagraphProperties = (elements = []) => elements.find((element) => element?.name === PARAGRAPH_PROPERTIES_XML_NAME) ?? null, hasParagraphProperties = (elements = []) => elements.some((element) => element?.name === PARAGRAPH_PROPERTIES_XML_NAME), cloneParagraphPropertiesForRenderedResult = (paragraphProperties) => {
+  const elements = (paragraphProperties.elements || []).filter((element) => element?.name !== "w:sectPr").map((element) => carbonCopy(element));
+  if (elements.length === 0)
+    return null;
+  return {
+    ...carbonCopy(paragraphProperties),
+    elements
+  };
+}, inheritWrapperParagraphProperties = (blockFieldElement, paragraphProperties) => {
+  if (!paragraphProperties)
+    return blockFieldElement;
+  const fieldElements = Array.isArray(blockFieldElement?.elements) ? blockFieldElement.elements : [];
+  const firstParagraphIndex = fieldElements.findIndex((element) => element?.name === "w:p");
+  if (firstParagraphIndex < 0)
+    return blockFieldElement;
+  const firstParagraph = fieldElements[firstParagraphIndex];
+  const firstParagraphElements = Array.isArray(firstParagraph.elements) ? firstParagraph.elements : [];
+  if (hasParagraphProperties(firstParagraphElements))
+    return blockFieldElement;
+  const renderedParagraphProperties = cloneParagraphPropertiesForRenderedResult(paragraphProperties);
+  const inheritedFirstParagraph = {
+    ...firstParagraph,
+    elements: renderedParagraphProperties ? [renderedParagraphProperties, ...firstParagraphElements] : firstParagraphElements
+  };
+  return {
+    ...blockFieldElement,
+    attributes: {
+      ...blockFieldElement.attributes || {},
+      wrapperParagraphProperties: carbonCopy(paragraphProperties)
+    },
+    elements: fieldElements.map((element, index2) => index2 === firstParagraphIndex ? inheritedFirstParagraph : element)
+  };
+}, hoistBlockFieldNodes = (params3, paragraphNode) => {
   const paragraphElements = Array.isArray(paragraphNode?.elements) ? paragraphNode.elements : [];
   const blockFieldElements = paragraphElements.filter((element) => BLOCK_FIELD_XML_NAMES.has(element?.name));
   if (blockFieldElements.length === 0)
     return null;
   const nodes = [];
   const remainingElements = paragraphElements.filter((element) => !BLOCK_FIELD_XML_NAMES.has(element?.name));
+  const wrapperParagraphProperties = findParagraphProperties(remainingElements);
+  const shouldTransferWrapperProperties = !hasMeaningfulParagraphContent(remainingElements);
   if (hasMeaningfulParagraphContent(remainingElements)) {
     const paragraph2 = translator.encode({
       ...params3,
@@ -125081,9 +125030,10 @@ var isRegExp = (value) => {
       nodes.push(paragraph2);
   }
   blockFieldElements.forEach((blockFieldElement) => {
+    const fieldElement = shouldTransferWrapperProperties ? inheritWrapperParagraphProperties(blockFieldElement, wrapperParagraphProperties) : blockFieldElement;
     nodes.push(...params3.nodeListHandler.handler({
       ...params3,
-      nodes: [blockFieldElement],
+      nodes: [fieldElement],
       path: [...params3.path || [], paragraphNode]
     }));
   });
@@ -126081,7 +126031,7 @@ var isRegExp = (value) => {
     nodes: Array.isArray(result) ? result : [result],
     consumed: 1
   };
-}, smartTagNodeEntityHandler, footnoteReferenceHandlerEntity, endnoteReferenceHandlerEntity, tableNodeHandlerEntity, tableOfContentsHandlerEntity, indexHandlerEntity, indexEntryHandlerEntity, bibliographyHandlerEntity, commentRangeStartHandlerEntity, commentRangeEndHandlerEntity, permStartHandlerEntity, permEndHandlerEntity, handleMathPara = (params3) => {
+}, smartTagNodeEntityHandler, footnoteReferenceHandlerEntity, endnoteReferenceHandlerEntity, tableNodeHandlerEntity, tableOfContentsHandlerEntity, indexHandlerEntity, indexEntryHandlerEntity, bibliographyHandlerEntity, tableOfAuthoritiesHandlerEntity, commentRangeStartHandlerEntity, commentRangeEndHandlerEntity, permStartHandlerEntity, permEndHandlerEntity, handleMathPara = (params3) => {
   const { nodes } = params3;
   if (!nodes.length || nodes[0].name !== "m:oMathPara")
     return {
@@ -126333,6 +126283,7 @@ var isRegExp = (value) => {
     tableOfContentsHandlerEntity,
     indexHandlerEntity,
     bibliographyHandlerEntity,
+    tableOfAuthoritiesHandlerEntity,
     indexEntryHandlerEntity,
     autoPageHandlerEntity,
     autoTotalPageCountEntity,
@@ -129120,29 +129071,7 @@ var isRegExp = (value) => {
     return null;
   const mapped = endnoteNumberById?.[key];
   return typeof mapped === "number" && Number.isFinite(mapped) && mapped > 0 ? mapped : null;
-}, sdtMetadataCache, getIndexChildren = (node3) => {
-  if (Array.isArray(node3.content))
-    return node3.content;
-  const content$2 = node3.content;
-  if (content$2 && typeof content$2.forEach === "function") {
-    const children = [];
-    content$2.forEach((child) => {
-      children.push(child);
-    });
-    return children;
-  }
-  return [];
-}, NON_RENDERED_STRUCTURAL_INLINE_TYPES, getChildren$1 = (node3) => {
-  if (Array.isArray(node3.content))
-    return node3.content;
-  const content$2 = node3.content;
-  if (content$2 && typeof content$2.forEach === "function") {
-    const children = [];
-    content$2.forEach((child) => children.push(child));
-    return children;
-  }
-  return [];
-}, getChildren = (node3) => {
+}, sdtMetadataCache, getParagraphContainerChildren = (node3) => {
   if (Array.isArray(node3.content))
     return node3.content;
   const content$2 = node3.content;
@@ -129152,7 +129081,7 @@ var isRegExp = (value) => {
     return children;
   }
   return [];
-}, NON_BREAKING_HYPHEN = "‑", DEFAULT_IMAGE_DIMENSION_PX = 100, isNodeHidden = (node3) => {
+}, NON_RENDERED_STRUCTURAL_INLINE_TYPES, PARAGRAPH_CONTAINER_TYPES, NON_BREAKING_HYPHEN = "‑", DEFAULT_IMAGE_DIMENSION_PX = 100, isNodeHidden = (node3) => {
   const attrs = node3.attrs ?? {};
   if (attrs.hidden === true)
     return true;
@@ -130320,7 +130249,7 @@ var isRegExp = (value) => {
       state.kern = kernNode.attributes["w:val"];
   }
 }, SuperConverter;
-var init_SuperConverter_B_oz3OyP_es = __esm(() => {
+var init_SuperConverter_nmIRMGtB_es = __esm(() => {
   init_rolldown_runtime_Bg48TavK_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
@@ -146709,8 +146638,8 @@ var init_SuperConverter_B_oz3OyP_es = __esm(() => {
         ...params3.node,
         attrs: change
       } });
-      const hasParagraphProperties = Object.prototype.hasOwnProperty.call(change, "paragraphProperties");
-      const paragraphProperties = hasParagraphProperties ? change.paragraphProperties : undefined;
+      const hasParagraphProperties$1 = Object.prototype.hasOwnProperty.call(change, "paragraphProperties");
+      const paragraphProperties = hasParagraphProperties$1 ? change.paragraphProperties : undefined;
       let pPrNode = paragraphProperties && typeof paragraphProperties === "object" ? pPrTranslator.decode({
         ...params3,
         node: {
@@ -146729,7 +146658,7 @@ var init_SuperConverter_B_oz3OyP_es = __esm(() => {
           };
         pPrNode.elements = [...pPrNode.elements || [], sectPr];
       }
-      if (!pPrNode && hasParagraphProperties)
+      if (!pPrNode && hasParagraphProperties$1)
         pPrNode = {
           name: "w:pPr",
           type: "element",
@@ -147076,6 +147005,12 @@ var init_SuperConverter_B_oz3OyP_es = __esm(() => {
     "permStart",
     "permEnd"
   ]);
+  BLOCK_FIELD_XML_NAMES = new Set([
+    "sd:tableOfContents",
+    "sd:index",
+    "sd:bibliography",
+    "sd:tableOfAuthorities"
+  ]);
   factor16 = Math.pow(2, 16);
   StepMap.empty = new StepMap([]);
   stepsByID = Object.create(null);
@@ -166572,12 +166507,6 @@ var init_SuperConverter_B_oz3OyP_es = __esm(() => {
     handlerName: "textNodeHandler",
     handler: handleTextNode
   };
-  BLOCK_FIELD_XML_NAMES = new Set([
-    "sd:tableOfContents",
-    "sd:index",
-    "sd:bibliography",
-    "sd:tableOfAuthorities"
-  ]);
   paragraphNodeHandlerEntity = {
     handlerName: "paragraphNodeHandler",
     handler: handleParagraphNode$1
@@ -167215,6 +167144,7 @@ var init_SuperConverter_B_oz3OyP_es = __esm(() => {
   indexHandlerEntity = generateV2HandlerEntity("indexHandler", translator$25);
   indexEntryHandlerEntity = generateV2HandlerEntity("indexEntryHandler", translator$26);
   bibliographyHandlerEntity = generateV2HandlerEntity("bibliographyHandler", translator$20);
+  tableOfAuthoritiesHandlerEntity = generateV2HandlerEntity("tableOfAuthoritiesHandler", translator$22);
   commentRangeStartHandlerEntity = generateV2HandlerEntity("commentRangeStartHandler", commentRangeStartTranslator);
   commentRangeEndHandlerEntity = generateV2HandlerEntity("commentRangeEndHandler", commentRangeEndTranslator);
   permStartHandlerEntity = generateV2HandlerEntity("permStartHandler", translator$15);
@@ -167514,6 +167444,11 @@ var init_SuperConverter_B_oz3OyP_es = __esm(() => {
     "permStart",
     "permEnd"
   ]);
+  PARAGRAPH_CONTAINER_TYPES = new Set([
+    "bibliography",
+    "index",
+    "tableOfAuthorities"
+  ]);
   VERTICAL_ELEMENTS = {
     "m:f": 0.6,
     "m:bar": 0.25,
@@ -167686,13 +167621,13 @@ var init_SuperConverter_B_oz3OyP_es = __esm(() => {
   nodeHandlers = {
     paragraph: handleParagraphNode,
     tableOfContents: handleTableOfContentsNode,
-    index: handleIndexNode,
+    index: handleParagraphContainerNode,
     structuredContentBlock: handleStructuredContentBlockNode,
     documentSection: handleDocumentSectionNode,
     table: handleTableNode,
     documentPartObject: handleDocumentPartObjectNode,
-    bibliography: handleBibliographyNode,
-    tableOfAuthorities: handleTableOfAuthoritiesNode,
+    bibliography: handleParagraphContainerNode,
+    tableOfAuthorities: handleParagraphContainerNode,
     image: handleImageNode,
     vectorShape: handleVectorShapeNode,
     shapeGroup: handleShapeGroupNode,
@@ -169003,7 +168938,7 @@ var init_SuperConverter_B_oz3OyP_es = __esm(() => {
   };
 });
 
-// ../../packages/superdoc/dist/chunks/create-headless-toolbar-M-9sCaKS.es.js
+// ../../packages/superdoc/dist/chunks/create-headless-toolbar-7bitVHMJ.es.js
 function parseSizeUnit(val = "0") {
   const length3 = val.toString() || "0";
   const value = Number.parseFloat(length3);
@@ -179334,8 +179269,8 @@ var CSS_DIMENSION_REGEX, DOM_SIZE_UNITS, normalizeActorId = (value) => {
     }
   };
 };
-var init_create_headless_toolbar_M_9sCaKS_es = __esm(() => {
-  init_SuperConverter_B_oz3OyP_es();
+var init_create_headless_toolbar_7bitVHMJ_es = __esm(() => {
+  init_SuperConverter_nmIRMGtB_es();
   init_uuid_qzgm05fK_es();
   init_constants_D_X7xF4s_es();
   init_dist_B8HfvhaK_es();
@@ -228498,7 +228433,7 @@ var init_remark_gfm_eZN6yzWQ_es = __esm(() => {
   init_remark_gfm_BhnWr3yf_es();
 });
 
-// ../../packages/superdoc/dist/chunks/src-D8E_vQxP.es.js
+// ../../packages/superdoc/dist/chunks/src-BrZa8lMN.es.js
 function deleteProps(obj, propOrProps) {
   const props = typeof propOrProps === "string" ? [propOrProps] : propOrProps;
   const removeNested = (target, pathParts, index2 = 0) => {
@@ -236140,7 +236075,7 @@ function setContent(content3, props) {
     else
       content3.textContent = props.content;
 }
-function getChildren2(popper$1) {
+function getChildren(popper$1) {
   var box = popper$1.firstElementChild;
   var boxChildren = arrayFrom(box.children);
   return {
@@ -236170,7 +236105,7 @@ function render(instance) {
   box.appendChild(content3);
   onUpdate(instance.props, instance.props);
   function onUpdate(prevProps, nextProps) {
-    var _getChildren = getChildren2(popper$1), box$1 = _getChildren.box, content$13 = _getChildren.content, arrow$2 = _getChildren.arrow;
+    var _getChildren = getChildren(popper$1), box$1 = _getChildren.box, content$13 = _getChildren.content, arrow$2 = _getChildren.arrow;
     if (nextProps.theme)
       box$1.setAttribute("data-theme", nextProps.theme);
     else
@@ -236297,7 +236232,7 @@ function createTippy(reference$1, passedProps) {
     return parent ? getOwnerDocument(parent) : document;
   }
   function getDefaultTemplateChildren() {
-    return getChildren2(popper$1);
+    return getChildren(popper$1);
   }
   function getDelay(isShow) {
     if (instance.state.isMounted && !instance.state.isVisible || currentInput.isTouch || lastTriggerEvent && lastTriggerEvent.type === "focus")
@@ -236534,7 +236469,7 @@ function createTippy(reference$1, passedProps) {
   function createPopperInstance() {
     destroyPopperInstance();
     var _instance$props2 = instance.props, popperOptions = _instance$props2.popperOptions, placement2 = _instance$props2.placement, offset$1 = _instance$props2.offset, getReferenceClientRect = _instance$props2.getReferenceClientRect, moveTransition = _instance$props2.moveTransition;
-    var arrow$2 = getIsDefaultRenderFn() ? getChildren2(popper$1).arrow : null;
+    var arrow$2 = getIsDefaultRenderFn() ? getChildren(popper$1).arrow : null;
     var computedReference = getReferenceClientRect ? {
       getBoundingClientRect: getReferenceClientRect,
       contextElement: getReferenceClientRect.contextElement || getCurrentTarget()
@@ -276263,7 +276198,7 @@ function selectionToRects(layout, blocks2, measures, from$1, to, geometryHelper)
           return;
         const block = blocks2[blockIndex];
         const pmRange = getAtomicPmRange(fragment2, block);
-        if (!rangesOverlap(pmRange.pmStart, pmRange.pmEnd, from$1, to))
+        if (!rangesOverlap2(pmRange.pmStart, pmRange.pmEnd, from$1, to))
           return;
         rects.push({
           x: fragment2.x,
@@ -277822,7 +277757,7 @@ function createLayoutMetrics(perf, startMark, layout, blocks2) {
     pageCount: layout.pages?.length ?? 0
   };
 }
-function buildFootnotesInput(editorState, converter, converterContext, themeColors, renderOverride = null) {
+function buildFootnotesInput(editorState, converter, converterContext, themeColors, renderOverride = null, resolveTrackedChangeColor) {
   if (!editorState)
     return null;
   const footnoteNumberById = converterContext?.footnoteNumberById;
@@ -277862,7 +277797,8 @@ function buildFootnotesInput(editorState, converter, converterContext, themeColo
         }),
         enableRichHyperlinks: true,
         themeColors,
-        converterContext
+        converterContext,
+        resolveTrackedChangeColor
       });
       if (result?.blocks?.length) {
         ensureFootnoteMarker(result.blocks, id2, footnoteNumberById);
@@ -283907,7 +283843,7 @@ function getHostEditor(editor) {
 function resolveSessionHostEditor(editor, runtime) {
   return getHostEditor(editor) ?? getHostEditor(runtime.editor) ?? runtime.editor;
 }
-function buildEndnoteBlocks(editorState, converter, converterContext, themeColors, renderOverride = null) {
+function buildEndnoteBlocks(editorState, converter, converterContext, themeColors, renderOverride = null, resolveTrackedChangeColor) {
   if (!editorState)
     return [];
   const endnoteNumberById = converterContext?.endnoteNumberById;
@@ -283945,7 +283881,8 @@ function buildEndnoteBlocks(editorState, converter, converterContext, themeColor
         }),
         enableRichHyperlinks: true,
         themeColors,
-        converterContext
+        converterContext,
+        resolveTrackedChangeColor
       });
       if (result?.blocks?.length) {
         ensureEndnoteMarker(result.blocks, id2, endnoteNumberById);
@@ -303794,30 +303731,56 @@ var Node$13 = class Node$14 {
 /* Global content-control chrome opt-out: preserve SDT wrappers/datasets while
  * suppressing built-in visual chrome on structured-content controls. Their
  * label elements are not emitted by renderer/helpers when this class is
- * present (DOM non-emission), and these rules neutralize
- * border/padding/hover/selection visuals. documentSection chrome (e.g. the
- * locked-section tooltip) is intentionally preserved and not in scope. */
-.superdoc-cc-chrome-none .superdoc-structured-content-inline,
+ * present (DOM non-emission). documentSection chrome (e.g. the locked-section
+ * tooltip) is intentionally preserved and not in scope.
+ *
+ * Custom styling surface (SD-3322): instead of fully erasing the look, these
+ * rules read --sd-content-controls-custom-* variables whose defaults reproduce
+ * the empty look (0-width transparent border, no background, no radius/padding).
+ * So chrome:'none' stays visually empty by default, but a consumer can paint
+ * their own field/clause look by setting those variables on the painted wrapper
+ * (target it via data-sdt-* attributes) - no !important, and no need to fight
+ * the .ProseMirror-selectednode / .sdt-group-hover state classes, because the
+ * painter reads the variables across rest, hover, and selected. The border is a
+ * full shorthand (e.g. "1px solid #1355ff"); its default "0 solid transparent"
+ * is identical in layout to no border. It's re-asserted in every state so the
+ * box never shifts (no jitter); only the background changes on hover/selected.
+ * Block controls add a -border-left override for an accent rail. */
+.superdoc-cc-chrome-none .superdoc-structured-content-inline {
+  padding: var(--sd-content-controls-custom-inline-padding, 0);
+  border: var(--sd-content-controls-custom-inline-border, 0 solid transparent);
+  border-radius: var(--sd-content-controls-custom-inline-radius, 0);
+  background: var(--sd-content-controls-custom-inline-bg, none);
+}
 .superdoc-cc-chrome-none .superdoc-structured-content-block {
-  border: none;
-  padding: 0;
-  border-radius: 0;
-  background: none;
+  padding: var(--sd-content-controls-custom-block-padding, 0);
+  border: var(--sd-content-controls-custom-block-border, 0 solid transparent);
+  border-left: var(--sd-content-controls-custom-block-border-left, var(--sd-content-controls-custom-block-border, 0 solid transparent));
+  border-radius: var(--sd-content-controls-custom-block-radius, 0);
+  background: var(--sd-content-controls-custom-block-bg, none);
 }
 
 .superdoc-cc-chrome-none .superdoc-structured-content-inline:hover,
+.superdoc-cc-chrome-none .superdoc-structured-content-inline[data-lock-mode]:hover {
+  border: var(--sd-content-controls-custom-inline-border, 0 solid transparent);
+  background: var(--sd-content-controls-custom-inline-hover-bg, var(--sd-content-controls-custom-inline-bg, none));
+}
 .superdoc-cc-chrome-none .superdoc-structured-content-block:hover,
 .superdoc-cc-chrome-none .superdoc-structured-content-block.sdt-group-hover,
-.superdoc-cc-chrome-none .superdoc-structured-content-block[data-lock-mode].sdt-group-hover,
-.superdoc-cc-chrome-none .superdoc-structured-content-inline[data-lock-mode]:hover {
-  border: none;
-  background: none;
+.superdoc-cc-chrome-none .superdoc-structured-content-block[data-lock-mode].sdt-group-hover {
+  border: var(--sd-content-controls-custom-block-border, 0 solid transparent);
+  border-left: var(--sd-content-controls-custom-block-border-left, var(--sd-content-controls-custom-block-border, 0 solid transparent));
+  background: var(--sd-content-controls-custom-block-hover-bg, var(--sd-content-controls-custom-block-bg, none));
 }
 
-.superdoc-cc-chrome-none .superdoc-structured-content-inline.ProseMirror-selectednode,
+.superdoc-cc-chrome-none .superdoc-structured-content-inline.ProseMirror-selectednode {
+  border: var(--sd-content-controls-custom-inline-border, 0 solid transparent);
+  background: var(--sd-content-controls-custom-inline-selected-bg, var(--sd-content-controls-custom-inline-hover-bg, var(--sd-content-controls-custom-inline-bg, none)));
+}
 .superdoc-cc-chrome-none .superdoc-structured-content-block.ProseMirror-selectednode {
-  border-color: transparent;
-  background: none;
+  border: var(--sd-content-controls-custom-block-border, 0 solid transparent);
+  border-left: var(--sd-content-controls-custom-block-border-left, var(--sd-content-controls-custom-block-border, 0 solid transparent));
+  background: var(--sd-content-controls-custom-block-selected-bg, var(--sd-content-controls-custom-block-hover-bg, var(--sd-content-controls-custom-block-bg, none)));
 }
 
 /* Hover highlight for SDT containers.
@@ -303866,11 +303829,20 @@ var Node$13 = class Node$14 {
   border: none;
 }
 
-/* Reset the lock-hover z-index boost so a suppressed SDT does not stack
- * above host-attached custom UI. Mirrors the base lock-hover selectors with
- * the chrome-none prefix so specificity stays above the boost rule. */
-.superdoc-cc-chrome-none .superdoc-structured-content-block[data-lock-mode].sdt-group-hover:not(.ProseMirror-selectednode),
+/* Chrome opt-out for the lock-hover affordance. The base lock-hover rules above
+ * paint a built-in tint and boost z-index on hovered locked controls; under
+ * chrome:'none' that would override the custom hover background and stack above
+ * host-attached UI. Re-assert the custom hover background (so a locked control
+ * follows --sd-content-controls-custom-*-hover-bg, defaulting to empty - no tint
+ * leaks) and reset the z-index. Mirrors the base lock-hover selectors with the
+ * chrome-none prefix, so the extra class wins over the base rules. Split inline
+ * vs block because each reads its own hover variable. */
 .superdoc-cc-chrome-none .superdoc-structured-content-inline[data-lock-mode]:hover:not(.ProseMirror-selectednode, [data-appearance='hidden']) {
+  background: var(--sd-content-controls-custom-inline-hover-bg, var(--sd-content-controls-custom-inline-bg, none));
+  z-index: auto;
+}
+.superdoc-cc-chrome-none .superdoc-structured-content-block[data-lock-mode].sdt-group-hover:not(.ProseMirror-selectednode) {
+  background: var(--sd-content-controls-custom-block-hover-bg, var(--sd-content-controls-custom-block-bg, none));
   z-index: auto;
 }
 
@@ -308491,7 +308463,47 @@ menclose::after {
     });
     return createErrorPlaceholder(fragment2.blockId, error3);
   }
-}, TRACK_CHANGE_BASE_CLASS, TRACK_CHANGE_OVERLAP_INSERT_DELETE_CLASS = "track-overlap-insert-delete-dec", TRACK_CHANGE_MODIFIER_CLASS, getTrackedChangeLayers$1 = (run2) => {
+}, TRACK_CHANGE_BASE_CLASS, TRACK_CHANGE_OVERLAP_INSERT_DELETE_CLASS = "track-overlap-insert-delete-dec", TRACK_CHANGE_BACKGROUND_ALPHA = 34, TRACK_CHANGE_BACKGROUND_FOCUSED_ALPHA = 68, expandHexColor = (hex) => {
+  const normalized = hex.replace("#", "");
+  if (normalized.length === 3)
+    return normalized.split("").map((char) => char + char).join("");
+  if (normalized.length === 6 || normalized.length === 8)
+    return normalized.slice(0, 6);
+  return null;
+}, colorWithAlpha = (color2, alpha) => {
+  const expanded = color2.trim().startsWith("#") ? expandHexColor(color2.trim()) : null;
+  if (!expanded)
+    return color2;
+  return `#${expanded}${Math.max(0, Math.min(255, alpha)).toString(16).padStart(2, "0")}`;
+}, setColorVar = (elem, name, value) => {
+  elem.style.setProperty(name, value);
+}, applyAuthorColorVariables = (elem, layer) => {
+  const color2 = layer.color;
+  if (!color2)
+    return;
+  const background = colorWithAlpha(color2, TRACK_CHANGE_BACKGROUND_ALPHA);
+  const backgroundFocused = colorWithAlpha(color2, TRACK_CHANGE_BACKGROUND_FOCUSED_ALPHA);
+  switch (layer.kind) {
+    case "insert":
+      setColorVar(elem, "--sd-tracked-changes-insert-border", color2);
+      setColorVar(elem, "--sd-tracked-changes-insert-background", background);
+      setColorVar(elem, "--sd-tracked-changes-insert-background-focused", backgroundFocused);
+      break;
+    case "delete":
+      setColorVar(elem, "--sd-tracked-changes-delete-border", color2);
+      setColorVar(elem, "--sd-tracked-changes-delete-background", background);
+      setColorVar(elem, "--sd-tracked-changes-delete-background-focused", backgroundFocused);
+      setColorVar(elem, "--sd-tracked-changes-delete-text", color2);
+      break;
+    case "format":
+      setColorVar(elem, "--sd-tracked-changes-format-border", color2);
+      setColorVar(elem, "--sd-tracked-changes-format-background", background);
+      setColorVar(elem, "--sd-tracked-changes-format-background-focused", backgroundFocused);
+      break;
+    default:
+      break;
+  }
+}, TRACK_CHANGE_MODIFIER_CLASS, getTrackedChangeLayers$1 = (run2) => {
   if (Array.isArray(run2.trackedChanges) && run2.trackedChanges.length > 0)
     return run2.trackedChanges;
   return run2.trackedChange ? [run2.trackedChange] : [];
@@ -308528,6 +308540,7 @@ menclose::after {
     const modifier = TRACK_CHANGE_MODIFIER_CLASS[layer.kind]?.[config2.mode];
     if (modifier)
       elem.classList.add(modifier);
+    applyAuthorColorVariables(elem, layer);
   });
   if (overlap) {
     elem.classList.add(TRACK_CHANGE_OVERLAP_INSERT_DELETE_CLASS);
@@ -314086,7 +314099,7 @@ menclose::after {
       };
   }
   return null;
-}, logSelectionMapDebug = (payload) => {}, rangesOverlap = (startA, endA, startB, endB) => {
+}, logSelectionMapDebug = (payload) => {}, rangesOverlap2 = (startA, endA, startB, endB) => {
   if (startA == null)
     return false;
   return (endA ?? startA + 1) > startB && startA < endB;
@@ -319514,13 +319527,13 @@ menclose::after {
     return;
   console.log(...args$1);
 }, HEADER_FOOTER_INIT_BUDGET_MS = 200, MAX_ZOOM_WARNING_THRESHOLD = 10, MAX_SELECTION_RECTS_PER_USER = 100, SEMANTIC_RESIZE_DEBOUNCE_MS = 120, MIN_SEMANTIC_CONTENT_WIDTH_PX = 1, GLOBAL_PERFORMANCE, PresentationEditor, ICONS, TEXTS, tableActionsOptions, TRACKED_MARK_NAMES;
-var init_src_D8E_vQxP_es = __esm(() => {
+var init_src_BrZa8lMN_es = __esm(() => {
   init_rolldown_runtime_Bg48TavK_es();
-  init_SuperConverter_B_oz3OyP_es();
+  init_SuperConverter_nmIRMGtB_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
   init_uuid_qzgm05fK_es();
-  init_create_headless_toolbar_M_9sCaKS_es();
+  init_create_headless_toolbar_7bitVHMJ_es();
   init_constants_D_X7xF4s_es();
   init_dist_B8HfvhaK_es();
   init_unified_Dsuw2be5_es();
@@ -326948,6 +326961,10 @@ ${err.toString()}`);
           renderDOM: (attrs) => {
             return attrs.sdBlockId ? { "data-sd-block-id": attrs.sdBlockId } : {};
           }
+        },
+        wrapperParagraphProperties: {
+          default: null,
+          rendered: false
         }
       };
     }
@@ -330345,10 +330362,18 @@ ${err.toString()}`);
           default: "",
           rendered: false
         },
+        instructionTokens: {
+          default: null,
+          rendered: false
+        },
         sdBlockId: {
           default: null,
           rendered: false
         },
+        wrapperParagraphProperties: {
+          default: null,
+          rendered: false
+        },
         style: {
           default: null,
           rendered: false
@@ -330449,6 +330474,10 @@ ${err.toString()}`);
         sdBlockId: {
           default: null,
           rendered: false
+        },
+        wrapperParagraphProperties: {
+          default: null,
+          rendered: false
         }
       };
     },
@@ -347466,6 +347495,7 @@ function print() { __p += __j.call(arguments, '') }
         flowMode: requestedFlowMode,
         semanticOptions: options.layoutEngineOptions?.semanticOptions,
         trackedChanges: options.layoutEngineOptions?.trackedChanges,
+        resolveTrackedChangeColor: options.layoutEngineOptions?.resolveTrackedChangeColor,
         emitCommentPositionsInViewing: options.layoutEngineOptions?.emitCommentPositionsInViewing,
         enableCommentsInViewing: options.layoutEngineOptions?.enableCommentsInViewing,
         presence: validatedPresence,
@@ -350836,6 +350866,7 @@ function print() { __p += __j.call(arguments, '') }
             sectionMetadata,
             trackedChangesMode: this.#trackedChangesMode,
             enableTrackedChanges: this.#trackedChangesEnabled,
+            resolveTrackedChangeColor: this.#layoutOptions.resolveTrackedChangeColor,
             enableComments: commentsEnabled,
             enableRichHyperlinks: true,
             themeColors: this.#editor?.converter?.themeColors ?? undefined,
@@ -350867,10 +350898,10 @@ function print() { __p += __j.call(arguments, '') }
         const isSemanticFlow = this.#isSemanticFlowMode();
         const baseLayoutOptions = this.#resolveLayoutOptions(blocks2, sectionMetadata);
         const activeFootnoteOverride = this.#buildActiveNoteRenderOverride("footnote");
-        const footnotesLayoutInput = buildFootnotesInput(this.#editor?.state, this.#editor?.converter, converterContext, this.#editor?.converter?.themeColors ?? undefined, activeFootnoteOverride);
+        const footnotesLayoutInput = buildFootnotesInput(this.#editor?.state, this.#editor?.converter, converterContext, this.#editor?.converter?.themeColors ?? undefined, activeFootnoteOverride, this.#layoutOptions.resolveTrackedChangeColor);
         const semanticFootnoteBlocks = isSemanticFlow ? buildSemanticFootnoteBlocks(footnotesLayoutInput, this.#layoutOptions.semanticOptions?.footnotesMode) : [];
         const activeEndnoteOverride = this.#buildActiveNoteRenderOverride("endnote");
-        const endnoteBlocks = buildEndnoteBlocks(this.#editor?.state, this.#editor?.converter, converterContext, this.#editor?.converter?.themeColors ?? undefined, activeEndnoteOverride);
+        const endnoteBlocks = buildEndnoteBlocks(this.#editor?.state, this.#editor?.converter, converterContext, this.#editor?.converter?.themeColors ?? undefined, activeEndnoteOverride, this.#layoutOptions.resolveTrackedChangeColor);
         const blocksForLayout = semanticFootnoteBlocks.length > 0 || endnoteBlocks.length > 0 ? [
           ...blocks2,
           ...semanticFootnoteBlocks,
@@ -353668,11 +353699,11 @@ function print() { __p += __j.call(arguments, '') }
   ]);
 });
 
-// ../../packages/superdoc/dist/chunks/create-super-doc-ui-D6OeR-D6.es.js
+// ../../packages/superdoc/dist/chunks/create-super-doc-ui-DZGOzt3u.es.js
 var MOD_ALIASES, ALT_ALIASES, CTRL_ALIASES, SHIFT_ALIASES, BUILTIN_CONTEXT_MENU_GROUPS, BUILTIN_GROUP_ORDER, RESERVED_PROXY_PROPERTY_NAMES, ALL_TOOLBAR_COMMAND_IDS, EMPTY_ACTIVE_IDS;
-var init_create_super_doc_ui_D6OeR_D6_es = __esm(() => {
-  init_SuperConverter_B_oz3OyP_es();
-  init_create_headless_toolbar_M_9sCaKS_es();
+var init_create_super_doc_ui_DZGOzt3u_es = __esm(() => {
+  init_SuperConverter_nmIRMGtB_es();
+  init_create_headless_toolbar_7bitVHMJ_es();
   MOD_ALIASES = new Set([
     "Mod",
     "Meta",
@@ -353714,16 +353745,16 @@ var init_zipper_yaJVJ4z9_es = __esm(() => {
 
 // ../../packages/superdoc/dist/super-editor.es.js
 var init_super_editor_es = __esm(() => {
-  init_src_D8E_vQxP_es();
-  init_SuperConverter_B_oz3OyP_es();
+  init_src_BrZa8lMN_es();
+  init_SuperConverter_nmIRMGtB_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
-  init_create_headless_toolbar_M_9sCaKS_es();
+  init_create_headless_toolbar_7bitVHMJ_es();
   init_constants_D_X7xF4s_es();
   init_dist_B8HfvhaK_es();
   init_unified_Dsuw2be5_es();
   init_DocxZipper_nv_KfOqb_es();
-  init_create_super_doc_ui_D6OeR_D6_es();
+  init_create_super_doc_ui_DZGOzt3u_es();
   init_ui_C5PAS9hY_es();
   init_eventemitter3_BnGqBE_Q_es();
   init_errors_CNaD6vcg_es();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli",
-  "version": "0.16.0-next.2",
+  "version": "0.16.0-next.4",
   "type": "module",
   "bin": {
     "superdoc": "./dist/index.js"
@@ -25,19 +25,19 @@
     "@types/ws": "^8.5.13",
     "typescript": "^5.9.2",
     "@superdoc/document-api": "0.0.1",
-    "@superdoc/super-editor": "0.0.1",
-    "superdoc": "1.38.0"
+    "superdoc": "1.38.0",
+    "@superdoc/super-editor": "0.0.1"
   },
   "module": "src/index.ts",
   "publishConfig": {
     "access": "public"
   },
   "optionalDependencies": {
-    "@superdoc-dev/cli-darwin-arm64": "0.16.0-next.2",
-    "@superdoc-dev/cli-darwin-x64": "0.16.0-next.2",
-    "@superdoc-dev/cli-linux-x64": "0.16.0-next.2",
-    "@superdoc-dev/cli-linux-arm64": "0.16.0-next.2",
-    "@superdoc-dev/cli-windows-x64": "0.16.0-next.2"
+    "@superdoc-dev/cli-darwin-arm64": "0.16.0-next.4",
+    "@superdoc-dev/cli-linux-x64": "0.16.0-next.4",
+    "@superdoc-dev/cli-darwin-x64": "0.16.0-next.4",
+    "@superdoc-dev/cli-linux-arm64": "0.16.0-next.4",
+    "@superdoc-dev/cli-windows-x64": "0.16.0-next.4"
   },
   "scripts": {
     "predev": "node scripts/ensure-superdoc-build.js",