@superdoc-dev/cli 0.17.0-next.44 → 0.17.0-next.46

package/dist/index.js

@@ -2055,7 +2055,7 @@ More content with **bold** and *italic*.`
     },
     "blocks.list": {
       memberPath: "blocks.list",
-      description: "List top-level blocks in document order with IDs, types, text previews, and optional full text when includeText:true. Supports pagination via offset/limit, optional nodeType filtering, and single-story scoping via `in: <StoryLocator>`.",
+      description: "List top-level blocks in document order with IDs, types, text previews, and optional full text when includeText:true. Text, previews, lengths, and formatting hints use the VISIBLE model: pending tracked deletions are excluded (matching how edit refs resolve), and inline atoms render as a single placeholder character. Supports pagination via offset/limit, optional nodeType filtering, and single-story scoping via `in: <StoryLocator>`.",
       expectedResult: "Returns a BlocksListResult with total block count, an ordered array of block entries (ordinal, nodeId, nodeType, textPreview, optional text, isEmpty), and the current document revision.",
       requiresDocumentContext: true,
       metadata: readOperation({
@@ -2899,13 +2899,13 @@ More content with **bold** and *italic*.`
     },
     "lists.attach": {
       memberPath: "lists.attach",
-      description: "Convert non-list paragraphs to list items under an existing list sequence.",
+      description: 'Convert non-list paragraphs to list items under an existing list sequence. With changeMode:"tracked" the former (unnumbered) paragraph properties are recorded as a w:pPrChange so a reviewer can accept/reject the numbering.',
       expectedResult: "Returns a ListsMutateItemResult confirming attachment.",
       requiresDocumentContext: true,
       metadata: mutationOperation({
         idempotency: "conditional",
         supportsDryRun: true,
-        supportsTrackedMode: false,
+        supportsTrackedMode: true,
         possibleFailureCodes: ["INVALID_TARGET", "NO_OP"],
         throws: [...T_NOT_FOUND_CAPABLE, "INVALID_TARGET"]
       }),
@@ -11013,6 +11013,27 @@ var init_schemas = __esm(() => {
               },
               additionalProperties: false
             },
+            numbering: {
+              type: "object",
+              description: 'Computed numbering rendering (marker/path/kind) for numbered list items and numbered headings — e.g. the rendered clause label "2.3.". Absent for non-numbered blocks.',
+              properties: {
+                marker: { oneOf: [{ type: "string" }, { type: "null" }] },
+                path: { oneOf: [{ type: "array", items: { type: "number" } }, { type: "null" }] },
+                kind: { oneOf: [{ type: "string" }, { type: "null" }] }
+              },
+              additionalProperties: false
+            },
+            indent: {
+              type: "object",
+              description: "Direct paragraph indentation in twips (only non-zero fields present).",
+              properties: {
+                left: { type: "number" },
+                right: { type: "number" },
+                firstLine: { type: "number" },
+                hanging: { type: "number" }
+              },
+              additionalProperties: false
+            },
             ref: {
               type: "string",
               description: "Ref handle for this block. Pass directly to superdoc_format or superdoc_edit ref param. Only present for non-empty blocks."
@@ -12524,6 +12545,10 @@ var init_schemas = __esm(() => {
                 moveRole: {
                   enum: ["pair", "source", "destination"],
                   description: "Optional move pairing assertion. 'pair' requires the resolved tracked change to be a paired move; 'source' / 'destination' further narrow to a specific half. When the assertion does not hold the decide adapter fails closed."
+                },
+                side: {
+                  enum: ["inserted", "deleted"],
+                  description: "Optional replacement side. When the id resolves to a paired replacement, decides only the 'inserted' or 'deleted' half, leaving the other half as a standalone pending change."
                 }
               }, ["kind", "id"]),
               objectSchema({
@@ -12560,6 +12585,10 @@ var init_schemas = __esm(() => {
                 moveRole: {
                   enum: ["pair", "source", "destination"],
                   description: "Optional move pairing assertion. 'pair' requires the resolved tracked change to be a paired move; 'source' / 'destination' further narrow to a specific half. When the assertion does not hold the decide adapter fails closed."
+                },
+                side: {
+                  enum: ["inserted", "deleted"],
+                  description: "Optional replacement side. When the id resolves to a paired replacement, decides only the 'inserted' or 'deleted' half."
                 }
               }, ["id"]),
               objectSchema({
@@ -17601,10 +17630,11 @@ function executeTrackChangesDecide(adapter, rawInput, options) {
     return adapter.rejectAll(input, revisionOptions);
   }
   const { id, story } = canonical.target;
+  const side = canonical.target.side;
   if (canonical.decision === "accept") {
-    return adapter.accept({ id, ...story ? { story } : {} }, revisionOptions);
+    return adapter.accept({ id, ...story ? { story } : {}, ...side ? { side } : {} }, revisionOptions);
   }
-  return adapter.reject({ id, ...story ? { story } : {} }, revisionOptions);
+  return adapter.reject({ id, ...story ? { story } : {}, ...side ? { side } : {} }, revisionOptions);
 }
 function isValidLegacyPartialIdRangeTarget(input) {
   if (typeof input !== "object" || input == null)
@@ -17650,11 +17680,13 @@ function normalizeReviewDecideTarget(target) {
     }
     const story = readOptionalStory(target, "target.story", false);
     const moveRole = readOptionalMoveRole(target);
+    const side = readOptionalReplacementSide(target);
     return {
       kind: "id",
       id,
       ...story ? { story } : {},
-      ...moveRole ? { moveRole } : {}
+      ...moveRole ? { moveRole } : {},
+      ...side ? { side } : {}
     };
   }
   if (kind === "range") {
@@ -17729,11 +17761,13 @@ function normalizeReviewDecideTarget(target) {
     if (typeof target.id === "string" && target.id.length > 0) {
       const story = readOptionalStory(target, "target.story", false);
       const moveRole = readOptionalMoveRole(target);
+      const side = readOptionalReplacementSide(target);
       return {
         kind: "id",
         id: target.id,
         ...story ? { story } : {},
-        ...moveRole ? { moveRole } : {}
+        ...moveRole ? { moveRole } : {},
+        ...side ? { side } : {}
       };
     }
   }
@@ -17850,6 +17884,18 @@ function readOptionalMoveRole(target) {
   }
   return moveRole;
 }
+function readOptionalReplacementSide(target) {
+  if (!("side" in target))
+    return;
+  const side = target.side;
+  if (side === undefined || side === null)
+    return;
+  if (side === "inserted")
+    return "inserted";
+  if (side === "deleted")
+    return "deleted";
+  throw new DocumentApiValidationError("INVALID_TARGET", 'trackChanges.decide id target.side must be "inserted" or "deleted" when provided.', { field: "target.side", value: side });
+}
 function validateRangeTargetSide(side) {
   if (side === "insert" || side === "inserted" || side === "delete" || side === "deleted" || side === "source" || side === "destination") {
     return;
@@ -68164,7 +68210,7 @@ var init_remark_gfm_BUJjZJLy_es = __esm(() => {
   emptyOptions2 = {};
 });
 
-// ../../packages/superdoc/dist/chunks/SuperConverter-Ed3nFN54.es.js
+// ../../packages/superdoc/dist/chunks/SuperConverter-DlrS7cQT.es.js
 function getExtensionConfigField(extension$1, field, context = { name: "" }) {
   const fieldValue = extension$1.config[field];
   if (typeof fieldValue === "function")
@@ -71946,14 +71992,17 @@ function executeTrackChangesDecide2(adapter, rawInput, options) {
     return adapter.rejectAll(input, revisionOptions);
   }
   const { id: id2, story } = canonical.target;
+  const side = canonical.target.side;
   if (canonical.decision === "accept")
     return adapter.accept({
       id: id2,
-      ...story ? { story } : {}
+      ...story ? { story } : {},
+      ...side ? { side } : {}
     }, revisionOptions);
   return adapter.reject({
     id: id2,
-    ...story ? { story } : {}
+    ...story ? { story } : {},
+    ...side ? { side } : {}
   }, revisionOptions);
 }
 function isValidLegacyPartialIdRangeTarget2(input) {
@@ -72004,11 +72053,13 @@ function normalizeReviewDecideTarget2(target) {
       });
     const story = readOptionalStory2(target, "target.story", false);
     const moveRole = readOptionalMoveRole2(target);
+    const side = readOptionalReplacementSide2(target);
     return {
       kind: "id",
       id: id2,
       ...story ? { story } : {},
-      ...moveRole ? { moveRole } : {}
+      ...moveRole ? { moveRole } : {},
+      ...side ? { side } : {}
     };
   }
   if (kind === "range") {
@@ -72099,11 +72150,13 @@ function normalizeReviewDecideTarget2(target) {
     if (typeof target.id === "string" && target.id.length > 0) {
       const story = readOptionalStory2(target, "target.story", false);
       const moveRole = readOptionalMoveRole2(target);
+      const side = readOptionalReplacementSide2(target);
       return {
         kind: "id",
         id: target.id,
         ...story ? { story } : {},
-        ...moveRole ? { moveRole } : {}
+        ...moveRole ? { moveRole } : {},
+        ...side ? { side } : {}
       };
     }
   }
@@ -72259,6 +72312,21 @@ function readOptionalMoveRole2(target) {
     });
   return moveRole;
 }
+function readOptionalReplacementSide2(target) {
+  if (!("side" in target))
+    return;
+  const side = target.side;
+  if (side === undefined || side === null)
+    return;
+  if (side === "inserted")
+    return "inserted";
+  if (side === "deleted")
+    return "deleted";
+  throw new DocumentApiValidationError2("INVALID_TARGET", 'trackChanges.decide id target.side must be "inserted" or "deleted" when provided.', {
+    field: "target.side",
+    value: side
+  });
+}
 function validateRangeTargetSide2(side) {
   if (side === "insert" || side === "inserted" || side === "delete" || side === "deleted" || side === "source" || side === "destination")
     return;
@@ -80436,6 +80504,31 @@ function hasValidDrawingContent(drawingContent) {
     return false;
   return drawingChildren.some((child) => child && typeof child === "object" && (child.name === "wp:inline" || child.name === "wp:anchor"));
 }
+function resolvePprChangeWordId(params3, change) {
+  const idStr = String(change?.id ?? "");
+  const allocator = params3?.converter?.wordIdAllocator;
+  if (allocator) {
+    const partPath = params3?.currentPartPath || "word/document.xml";
+    const sourceId = /^\d+$/.test(idStr) ? idStr : undefined;
+    return String(allocator.allocate({
+      partPath,
+      sourceId,
+      logicalId: idStr
+    }));
+  }
+  return toDecimalWordId(change?.id);
+}
+function toDecimalWordId(id2) {
+  const str = String(id2);
+  if (/^\d+$/.test(str))
+    return str;
+  let hash = 2166136261;
+  for (let i$1 = 0;i$1 < str.length; i$1++) {
+    hash ^= str.charCodeAt(i$1);
+    hash = Math.imul(hash, 16777619);
+  }
+  return String(1e6 + (hash >>> 0) % 1e9);
+}
 function getSectPr(pPrNode) {
   const sectPr = pPrNode?.elements?.find((el) => el.name === "w:sectPr");
   return sectPr ? carbonCopy(sectPr) : undefined;
@@ -80605,6 +80698,8 @@ function generateParagraphProperties(params3) {
   const { node: node3 } = params3;
   const { attrs = {} } = node3;
   const paragraphProperties = carbonCopy(attrs.paragraphProperties || {});
+  if (params3?.isFinalDoc && paragraphProperties.change)
+    delete paragraphProperties.change;
   const inlineKeys = paragraphProperties.runPropertiesInlineKeys;
   delete paragraphProperties.runPropertiesInlineKeys;
   if (Array.isArray(inlineKeys) && inlineKeys.length === 0)
@@ -80621,10 +80716,14 @@ function generateParagraphProperties(params3) {
     wordIdAllocator: params3?.converter?.wordIdAllocator || null,
     partPath: resolveExportPartPath$1(params3)
   } : null;
-  let pPr = translator$129.decode({ node: {
-    ...node3,
-    attrs: { paragraphProperties }
-  } });
+  let pPr = translator$129.decode({
+    node: {
+      ...node3,
+      attrs: { paragraphProperties }
+    },
+    converter: params3?.converter,
+    currentPartPath: resolveExportPartPath$1(params3)
+  });
   if (!params3?.isFinalDoc && paragraphSplitTrackFormatMark) {
     const insertionElement = createParagraphSplitInsertionElement(paragraphSplitTrackFormatMark, paragraphSplitWordIdOptions);
     if (insertionElement)
@@ -91331,11 +91430,24 @@ function getDefinitionForLevel(data, level) {
     return cachedLevels.get(parsedLevel);
   return data?.elements?.find((item) => Number(item.attributes?.["w:ilvl"]) === parsedLevel);
 }
-function updateNumberingProperties(newNumberingProperties, paragraphNode, pos, editor, tr) {
+function updateNumberingProperties(newNumberingProperties, paragraphNode, pos, editor, tr, options = {}) {
+  const formerProperties = { ...paragraphNode.attrs.paragraphProperties || {} };
   const newProperties = {
-    ...paragraphNode.attrs.paragraphProperties || {},
+    ...formerProperties,
     numberingProperties: newNumberingProperties ? { ...newNumberingProperties } : null
   };
+  if (options.trackChange && newNumberingProperties && !formerProperties.change) {
+    const former = { ...formerProperties };
+    delete former.change;
+    const user = editor?.options?.user || {};
+    newProperties.change = {
+      id: v4_default(),
+      author: user.name || "",
+      authorEmail: user.email || "",
+      date: (/* @__PURE__ */ new Date()).toISOString(),
+      paragraphProperties: former
+    };
+  }
   if (!newNumberingProperties && paragraphNode.attrs.paragraphProperties?.styleId === "ListParagraph")
     newProperties.styleId = null;
   if (newProperties.indent)
@@ -113364,6 +113476,28 @@ function groupTrackedChanges(editor) {
       wordRevisionIds: structural.sourceId ? structural.side === "insertion" ? { insert: structural.sourceId } : { delete: structural.sourceId } : undefined
     });
   }
+  const pprChanges = enumeratePprChanges(editor.state);
+  for (const ppr of pprChanges) {
+    const excerpt = normalizeExcerpt(editor.state.doc.textBetween(ppr.from, ppr.to, " ", ""));
+    grouped.push({
+      rawId: ppr.id,
+      commandRawId: ppr.id,
+      id: ppr.id,
+      from: ppr.from,
+      to: ppr.to,
+      hasInsert: false,
+      hasDelete: false,
+      hasFormat: true,
+      attrs: {
+        id: ppr.id,
+        author: ppr.author || undefined,
+        authorEmail: ppr.authorEmail || undefined,
+        authorImage: ppr.authorImage || undefined,
+        date: ppr.date || undefined
+      },
+      excerpt
+    });
+  }
   grouped.sort((a, b) => {
     if (a.from !== b.from)
       return a.from - b.from;
@@ -113836,7 +113970,7 @@ function applyPagination(items, opts) {
   };
 }
 function resolveBlock(editor, nodeId) {
-  const matches$1 = getBlockIndex(editor).candidates.filter((c$1) => c$1.nodeId === nodeId && (c$1.nodeType === "paragraph" || c$1.nodeType === "listItem"));
+  const matches$1 = getBlockIndex(editor).candidates.filter((c$1) => c$1.nodeId === nodeId && (c$1.nodeType === "paragraph" || c$1.nodeType === "listItem" || c$1.nodeType === "heading"));
   if (matches$1.length === 0)
     throw new DocumentApiAdapterError("TARGET_NOT_FOUND", "Block target was not found.", { nodeId });
   if (matches$1.length > 1)
@@ -113854,7 +113988,7 @@ function resolveBlocksInRange(editor, fromId, toId$1) {
       from: fromId,
       to: toId$1
     });
-  return getBlockIndex(editor).candidates.filter((c$1) => (c$1.nodeType === "paragraph" || c$1.nodeType === "listItem") && c$1.pos >= from5.pos && c$1.pos <= to.pos);
+  return getBlockIndex(editor).candidates.filter((c$1) => (c$1.nodeType === "paragraph" || c$1.nodeType === "listItem" || c$1.nodeType === "heading") && c$1.pos >= from5.pos && c$1.pos <= to.pos);
 }
 function getAbstractNumId(editor, numId) {
   const definitions = editor.converter?.numbering?.definitions;
@@ -114089,7 +114223,15 @@ function getListText(candidate) {
 }
 function projectListItemCandidate(editor, candidate) {
   const attrs = candidate.node.attrs ?? {};
-  const { numId, level } = getNumberingProperties(candidate.node);
+  let { numId, level } = getNumberingProperties(candidate.node);
+  if (numId == null)
+    try {
+      const effective = calculateResolvedParagraphProperties(editor, candidate.node, editor.state.doc.resolve(candidate.pos))?.numberingProperties;
+      if (effective) {
+        numId = toFiniteNumber(effective.numId);
+        level = toFiniteNumber(effective.ilvl) ?? level ?? 0;
+      }
+    } catch {}
   const listRendering = getListRendering(attrs.listRendering);
   const path2 = listRendering?.path;
   const ordinal = getListOrdinalFromPath(path2);
@@ -114201,8 +114343,17 @@ function listListItems(editor, query2) {
     }
   });
 }
+function hasNumberingMetadata(candidate) {
+  const { numId } = getNumberingProperties(candidate.node);
+  if (numId != null)
+    return true;
+  return getListRendering((candidate.node.attrs ?? {}).listRendering) != null;
+}
 function resolveListItem(editor, address2) {
-  const matches$1 = getBlockIndex(editor).candidates.filter((candidate) => candidate.nodeType === "listItem" && candidate.nodeId === address2.nodeId);
+  const index2 = getBlockIndex(editor);
+  let matches$1 = index2.candidates.filter((candidate) => candidate.nodeType === "listItem" && candidate.nodeId === address2.nodeId);
+  if (matches$1.length === 0)
+    matches$1 = index2.candidates.filter((candidate) => candidate.nodeId === address2.nodeId && hasNumberingMetadata(candidate));
   if (matches$1.length === 0)
     throw new DocumentApiAdapterError("TARGET_NOT_FOUND", "List item target was not found.", { target: address2 });
   if (matches$1.length > 1)
@@ -136603,7 +136754,34 @@ Docs: https://docs.superdoc.dev/getting-started/fonts`);
         "data-track-change-date": change.date || ""
       }));
   }
-}, NOTE_REFERENCE_NODE_TYPES, storeByEditor, liveSessionsByHost, cacheByHost, hostStoreSyncedKeys, BODY_LOCATOR, groupedCache, SDT_NODE_NAMES, SDT_BLOCK_NAME = "structuredContentBlock", SDT_INLINE_NAME = "structuredContent", SDT_NODE_TYPES, VALID_CONTROL_TYPES, VALID_LOCK_MODES2, VALID_APPEARANCES, FIELD_LIKE_SDT_TYPES, liveDocumentCountsCache, BIBLIOGRAPHY_NAMESPACE_URI = "http://schemas.openxmlformats.org/officeDocument/2006/bibliography", CUSTOM_XML_RELATIONSHIP_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXml", CUSTOM_XML_PROPS_RELATIONSHIP_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXmlProps", DEFAULT_SELECTED_STYLE = "/APA.XSL", DEFAULT_STYLE_NAME = "APA", DEFAULT_VERSION = "6", API_TO_OOXML_SOURCE_TYPE, OOXML_TO_API_SOURCE_TYPE, SIMPLE_FIELD_TO_XML_TAG, XML_TAG_TO_SIMPLE_FIELD, import_lib2, FONT_FAMILY_FALLBACKS, DEFAULT_GENERIC_FALLBACK = "sans-serif", DEFAULT_FONT_SIZE_PT = 10, CURRENT_APP_VERSION = "1.43.1", SUPERDOC_DOCUMENT_ORIGIN_PROPERTY = "SuperdocDocumentOrigin", STORED_DOCUMENT_ORIGINS, collectRunDefaultProperties = (runProps, { allowOverrideTypeface = true, allowOverrideSize = true, themeResolver, state }) => {
+}, NOTE_REFERENCE_NODE_TYPES, storeByEditor, liveSessionsByHost, cacheByHost, hostStoreSyncedKeys, BODY_LOCATOR, enumeratePprChanges = (state) => {
+  const doc$2 = state?.doc;
+  if (!doc$2)
+    return [];
+  const out = [];
+  try {
+    doc$2.descendants((node3, pos) => {
+      if (node3.isText)
+        return false;
+      const change = node3?.attrs?.paragraphProperties?.change;
+      if (change && typeof change.id === "string" && change.id && change.paragraphProperties)
+        out.push({
+          id: change.id,
+          from: pos,
+          to: pos + node3.nodeSize,
+          author: change.author || "",
+          authorEmail: change.authorEmail || "",
+          authorImage: change.authorImage || "",
+          date: change.date || "",
+          formerProperties: change.paragraphProperties || {},
+          subtype: "paragraph-format"
+        });
+    });
+  } catch {
+    return out;
+  }
+  return out;
+}, groupedCache, SDT_NODE_NAMES, SDT_BLOCK_NAME = "structuredContentBlock", SDT_INLINE_NAME = "structuredContent", SDT_NODE_TYPES, VALID_CONTROL_TYPES, VALID_LOCK_MODES2, VALID_APPEARANCES, FIELD_LIKE_SDT_TYPES, liveDocumentCountsCache, BIBLIOGRAPHY_NAMESPACE_URI = "http://schemas.openxmlformats.org/officeDocument/2006/bibliography", CUSTOM_XML_RELATIONSHIP_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXml", CUSTOM_XML_PROPS_RELATIONSHIP_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXmlProps", DEFAULT_SELECTED_STYLE = "/APA.XSL", DEFAULT_STYLE_NAME = "APA", DEFAULT_VERSION = "6", API_TO_OOXML_SOURCE_TYPE, OOXML_TO_API_SOURCE_TYPE, SIMPLE_FIELD_TO_XML_TAG, XML_TAG_TO_SIMPLE_FIELD, import_lib2, FONT_FAMILY_FALLBACKS, DEFAULT_GENERIC_FALLBACK = "sans-serif", DEFAULT_FONT_SIZE_PT = 10, CURRENT_APP_VERSION = "1.43.1", SUPERDOC_DOCUMENT_ORIGIN_PROPERTY = "SuperdocDocumentOrigin", STORED_DOCUMENT_ORIGINS, collectRunDefaultProperties = (runProps, { allowOverrideTypeface = true, allowOverrideSize = true, themeResolver, state }) => {
   if (!runProps?.elements?.length || !state)
     return;
   const fontsNode = runProps.elements.find((el) => el.name === "w:rFonts");
@@ -136637,7 +136815,7 @@ Docs: https://docs.superdoc.dev/getting-started/fonts`);
       state.kern = kernNode.attributes["w:val"];
   }
 }, SuperConverter;
-var init_SuperConverter_Ed3nFN54_es = __esm(() => {
+var init_SuperConverter_DlrS7cQT_es = __esm(() => {
   init_rolldown_runtime_Bg48TavK_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
@@ -141515,6 +141693,8 @@ var init_SuperConverter_Ed3nFN54_es = __esm(() => {
         ...params3.node,
         attrs: change
       } });
+      if (decodedAttrs["w:id"] != null)
+        decodedAttrs["w:id"] = resolvePprChangeWordId(params3, change);
       const hasParagraphProperties$1 = Object.prototype.hasOwnProperty.call(change, "paragraphProperties");
       const paragraphProperties = hasParagraphProperties$1 ? change.paragraphProperties : undefined;
       let pPrNode = paragraphProperties && typeof paragraphProperties === "object" ? pPrTranslator.decode({
@@ -165253,7 +165433,15 @@ var init_SuperConverter_Ed3nFN54_es = __esm(() => {
     }
     async exportToDocx(jsonData, editorSchema, documentMedia, isFinalDoc = false, commentsExportType, comments = [], editor, exportJsonOnly = false, fieldsHighlightColor, preserveSdtWrappers = false) {
       this.exportWarnings = [];
-      const exportableComments = comments.filter((c$1) => !c$1.trackedChange);
+      const isSyntheticTrackedChangeRow = (c$1) => {
+        const linkId = c$1.trackedChangeLink?.trackedChangeId;
+        if (!c$1.trackedChange || !linkId)
+          return false;
+        const identity = c$1.commentId ?? c$1.id;
+        return identity != null && String(identity) === String(linkId);
+      };
+      const hasCommentBody = (c$1) => Boolean(typeof c$1.commentText === "string" && c$1.commentText.length > 0 || c$1.commentJSON || Array.isArray(c$1.elements) && c$1.elements.length || typeof c$1.text === "string" && c$1.text.length > 0);
+      const exportableComments = comments.filter((c$1) => !isSyntheticTrackedChangeRow(c$1) && !(c$1.trackedChange && !hasCommentBody(c$1)));
       const commentsWithParaIds = exportableComments.map((c$1) => prepareCommentParaIds(c$1));
       const commentDefinitions = commentsWithParaIds.map((c$1, index2) => getCommentDefinition(c$1, index2, commentsWithParaIds, editor));
       let statFieldCacheMap;
@@ -165643,7 +165831,7 @@ var init_SuperConverter_Ed3nFN54_es = __esm(() => {
   };
 });
 
-// ../../packages/superdoc/dist/chunks/create-headless-toolbar-PSeH6IV5.es.js
+// ../../packages/superdoc/dist/chunks/create-headless-toolbar-0mIJ8-xU.es.js
 function parseSizeUnit(val = "0") {
   const length3 = val.toString() || "0";
   const value = Number.parseFloat(length3);
@@ -170076,7 +170264,25 @@ function executeTextDelete(_editor, tr, target, _step, mapping) {
   tr.delete(absFrom, absTo);
   return { changed: true };
 }
-function applyAlignmentToRange(editor, tr, absFrom, absTo, alignment) {
+function withTrackedParagraphPropertyChange(editor, existing, nextParagraphProperties, changeMode) {
+  if (changeMode !== "tracked")
+    return nextParagraphProperties;
+  if (existing?.change)
+    return nextParagraphProperties;
+  const { change: _existingChange, ...formerProperties } = existing ?? {};
+  const user = editor?.options?.user ?? {};
+  return {
+    ...nextParagraphProperties,
+    change: {
+      id: v4_default(),
+      author: user.name || "",
+      authorEmail: user.email || "",
+      date: (/* @__PURE__ */ new Date()).toISOString(),
+      paragraphProperties: formerProperties
+    }
+  };
+}
+function applyAlignmentToRange(editor, tr, absFrom, absTo, alignment, changeMode) {
   if (!alignment)
     return false;
   let changed = false;
@@ -170087,10 +170293,10 @@ function applyAlignmentToRange(editor, tr, absFrom, absTo, alignment) {
     const justification = mapAlignmentToJustificationForParagraph(alignment, calculateResolvedParagraphProperties(editor, node3, typeof tr.doc.resolve === "function" ? tr.doc.resolve(pos) : null)?.rightToLeft === true);
     if (existing?.justification === justification)
       return;
-    const updated = {
+    const updated = withTrackedParagraphPropertyChange(editor, existing, {
       ...existing ?? {},
       justification
-    };
+    }, changeMode);
     tr.setNodeMarkup(pos, undefined, {
       ...node3.attrs,
       paragraphProperties: updated
@@ -170115,7 +170321,7 @@ function expandToBlockBoundaries$1(doc2, from5, to) {
     to: expandedTo
   };
 }
-function executeStyleApply3(editor, tr, target, step$1, mapping) {
+function executeStyleApply3(editor, tr, target, step$1, mapping, changeMode) {
   let absFrom = mapping.map(target.absFrom);
   let absTo = mapping.map(target.absTo);
   if (step$1.args.scope === "block") {
@@ -170127,7 +170333,7 @@ function executeStyleApply3(editor, tr, target, step$1, mapping) {
   if (step$1.args.inline)
     changed = applyInlinePatchToRange(editor, tr, absFrom, absTo, step$1.args.inline) || changed;
   if (step$1.args.alignment)
-    changed = applyAlignmentToRange(editor, tr, absFrom, absTo, step$1.args.alignment) || changed;
+    changed = applyAlignmentToRange(editor, tr, absFrom, absTo, step$1.args.alignment, changeMode) || changed;
   return { changed };
 }
 function validateMappedSpanContiguity(target, mapping, stepId) {
@@ -170198,7 +170404,7 @@ function executeSpanTextDelete(_editor, tr, target, step$1, mapping) {
   tr.delete(absFrom, absTo);
   return { changed: true };
 }
-function executeSpanStyleApply(editor, tr, target, step$1, mapping) {
+function executeSpanStyleApply(editor, tr, target, step$1, mapping, changeMode) {
   validateMappedSpanContiguity(target, mapping, step$1.id);
   const firstSeg = target.segments[0];
   const lastSeg = target.segments[target.segments.length - 1];
@@ -170213,7 +170419,7 @@ function executeSpanStyleApply(editor, tr, target, step$1, mapping) {
   if (step$1.args.inline)
     changed = applyInlinePatchToRange(editor, tr, absFrom, absTo, step$1.args.inline) || changed;
   if (step$1.args.alignment)
-    changed = applyAlignmentToRange(editor, tr, absFrom, absTo, step$1.args.alignment) || changed;
+    changed = applyAlignmentToRange(editor, tr, absFrom, absTo, step$1.args.alignment, changeMode) || changed;
   return { changed };
 }
 function getReplacementText(replacement) {
@@ -174831,7 +175037,7 @@ var CSS_DIMENSION_REGEX, DOM_SIZE_UNITS, MARK_KEYS, STEP_OP_CATALOG_UNFROZEN2, P
       init() {
         if (!editor.converter || editor.options.mode !== "docx")
           return {};
-        if (editor.presentationEditor)
+        if (editor.presentationEditor || editor.options?.isHeadless)
           return {
             styles: editor.converter?.linkedStyles || [],
             decorations: DecorationSet.empty
@@ -174845,7 +175051,7 @@ var CSS_DIMENSION_REGEX, DOM_SIZE_UNITS, MARK_KEYS, STEP_OP_CATALOG_UNFROZEN2, P
       apply(tr, prev, oldEditorState, newEditorState) {
         if (!editor.converter || editor.options.mode !== "docx")
           return { ...prev };
-        if (editor.presentationEditor)
+        if (editor.presentationEditor || editor.options?.isHeadless)
           return {
             ...prev,
             decorations: DecorationSet.empty
@@ -176446,9 +176652,9 @@ var CSS_DIMENSION_REGEX, DOM_SIZE_UNITS, MARK_KEYS, STEP_OP_CATALOG_UNFROZEN2, P
     }
   };
 };
-var init_create_headless_toolbar_PSeH6IV5_es = __esm(() => {
+var init_create_headless_toolbar_0mIJ8_xU_es = __esm(() => {
   init_rolldown_runtime_Bg48TavK_es();
-  init_SuperConverter_Ed3nFN54_es();
+  init_SuperConverter_DlrS7cQT_es();
   init_jszip_C49i9kUs_es();
   init_uuid_B2wVPhPi_es();
   init_constants_D9qj59G2_es();
@@ -226541,7 +226747,7 @@ var init_remark_gfm_DCND_V_3_es = __esm(() => {
   init_remark_gfm_BUJjZJLy_es();
 });
 
-// ../../packages/superdoc/dist/chunks/src-bMRzO9Kl.es.js
+// ../../packages/superdoc/dist/chunks/src-Dra6R0wc.es.js
 function deleteProps(obj, propOrProps) {
   const props = typeof propOrProps === "string" ? [propOrProps] : propOrProps;
   const removeNested = (target, pathParts, index2 = 0) => {
@@ -244573,7 +244779,7 @@ function trackChangesGetWrapper(editor, input2) {
     imported: Boolean(toNonEmptyString(resolved.change.attrs.sourceId))
   };
 }
-function decideSingle(hostEditor, decision, id2, story, options) {
+function decideSingle(hostEditor, decision, id2, story, options, side) {
   const resolved = resolveTrackedChangeInStory(hostEditor, {
     kind: "entity",
     entityType: "trackedChange",
@@ -244591,7 +244797,7 @@ function decideSingle(hostEditor, decision, id2, story, options) {
     throw new DocumentApiAdapterError("CAPABILITY_UNAVAILABLE", `${decision === "accept" ? "Accept" : "Reject"} tracked change command is not available on the story editor.`, { reason: "missing_command" });
   checkRevision(hostEditor, options?.expectedRevision);
   const commandRawId = resolved.change.commandRawId ?? resolved.change.rawId;
-  if (executeDomainCommand(resolved.editor, () => Boolean(command$1(commandRawId))).steps[0]?.effect !== "changed")
+  if (executeDomainCommand(resolved.editor, () => Boolean(command$1(commandRawId, side ? { side } : undefined))).steps[0]?.effect !== "changed")
     return decisionFailureReceipt(resolved.editor, `${decision === "accept" ? "Accept" : "Reject"} tracked change "${id2}" produced no change.`, {
       id: id2,
       story
@@ -244603,10 +244809,10 @@ function decideSingle(hostEditor, decision, id2, story, options) {
   return { success: true };
 }
 function trackChangesAcceptWrapper(editor, input2, options) {
-  return decideSingle(editor, "accept", input2.id, input2.story, options);
+  return decideSingle(editor, "accept", input2.id, input2.story, options, input2.side);
 }
 function trackChangesRejectWrapper(editor, input2, options) {
-  return decideSingle(editor, "reject", input2.id, input2.story, options);
+  return decideSingle(editor, "reject", input2.id, input2.story, options, input2.side);
 }
 function decideAll(editor, decision, input2, options) {
   const index2 = getTrackedChangeIndex(editor);
@@ -245672,6 +245878,7 @@ function replyToCommentHandler(editor, input2, options) {
     };
   if (trackedPayload && inheritedTrackedFields)
     emitCommentLifecycleUpdate(editor, "update", trackedPayload);
+  incrementRevision(editor);
   return {
     success: true,
     id: replyId,
@@ -248308,7 +248515,7 @@ function createHeadingWrapper(editor, input2, options) {
 function extractTextPreview(node3) {
   if (!node3.isTextblock)
     return null;
-  const text5 = node3.textContent;
+  const text5 = textContentInBlock(node3, { textModel: "visible" });
   if (text5.length <= TEXT_PREVIEW_MAX_LENGTH)
     return text5;
   return text5.slice(0, TEXT_PREVIEW_MAX_LENGTH);
@@ -248316,7 +248523,7 @@ function extractTextPreview(node3) {
 function extractBlockText$1(node3) {
   if (!node3.isTextblock)
     return null;
-  return node3.textContent;
+  return textContentInBlock(node3, { textModel: "visible" });
 }
 function buildStyleContext(editor) {
   const styleProps = readTranslatedLinkedStyles(editor);
@@ -248367,6 +248574,13 @@ function extractBlockNumbering(node3) {
 function extractBlockFormatting(node3, styleCtx) {
   const pProps = node3.attrs.paragraphProperties;
   const styleId$1 = pProps?.styleId ?? null;
+  const rawIndent = pProps?.indent;
+  const indent2 = rawIndent && typeof rawIndent === "object" ? Object.fromEntries([
+    "left",
+    "right",
+    "firstLine",
+    "hanging"
+  ].filter((k$1) => typeof rawIndent[k$1] === "number" && rawIndent[k$1] !== 0).map((k$1) => [k$1, rawIndent[k$1]])) : undefined;
   let fontFamily;
   let fontSize;
   let bold2;
@@ -248378,6 +248592,8 @@ function extractBlockFormatting(node3, styleCtx) {
     const marks = child.marks ?? [];
     if (!child.isText || marks.length === 0)
       return;
+    if (marks.some((mark2) => mark2.type.name === "trackDelete"))
+      return;
     for (const mark2 of marks) {
       const markName = mark2.type.name;
       const attrs = mark2.attrs;
@@ -248415,6 +248631,7 @@ function extractBlockFormatting(node3, styleCtx) {
     ...underline ? { underline } : {},
     ...color2 ? { color: color2 } : {},
     ...pProps?.justification ? { alignment: pProps.justification } : {},
+    ...indent2 && Object.keys(indent2).length > 0 ? { indent: indent2 } : {},
     ...headingLevel ? { headingLevel } : {}
   };
 }
@@ -248486,7 +248703,7 @@ function blocksListWrapper(editor, input2) {
   return {
     total,
     blocks: paged.map((candidate, i3) => {
-      const textLength = computeTextContentLength(candidate.node);
+      const textLength = computeTextContentLength(candidate.node, { textModel: "visible" });
       const fullText = input2?.includeText ? extractBlockText$1(candidate.node) : undefined;
       const numbering = extractBlockNumbering(candidate.node);
       const ref$1 = textLength > 0 ? encodeV4Ref({
@@ -248502,6 +248719,7 @@ function blocksListWrapper(editor, input2) {
         }],
         blockIndex: offset$1 + i3
       }) : undefined;
+      const listRendering = candidate.node.attrs?.listRendering;
       return {
         ordinal: offset$1 + i3,
         nodeId: candidate.nodeId,
@@ -248510,6 +248728,11 @@ function blocksListWrapper(editor, input2) {
         ...fullText !== undefined ? { text: fullText } : {},
         isEmpty: textLength === 0,
         ...extractBlockFormatting(candidate.node, styleCtx),
+        ...listRendering ? { numbering: {
+          marker: listRendering.markerText ?? null,
+          path: listRendering.path ?? null,
+          kind: listRendering.numberingType ?? null
+        } } : {},
         ...numbering ? { paragraphNumbering: numbering } : {},
         ...ref$1 ? { ref: ref$1 } : {}
       };
@@ -249842,7 +250065,9 @@ function listsCreateWrapper(editor, input2, options) {
   };
 }
 function listsAttachWrapper(editor, input2, options) {
-  rejectTrackedMode("lists.attach", options);
+  const trackChange = (options?.changeMode ?? "direct") === "tracked";
+  if (trackChange)
+    ensureTrackedCapability(editor, { operation: "lists.attach" });
   const attachTo = resolveListItem(editor, input2.attachTo);
   if (attachTo.numId == null)
     return toListsFailure$1("INVALID_TARGET", "attachTo target must be a list item with numbering metadata.", { attachTo: input2.attachTo });
@@ -249869,7 +250094,7 @@ function listsAttachWrapper(editor, input2, options) {
       updateNumberingProperties({
         numId,
         ilvl: level
-      }, block.node, block.pos, editor, tr);
+      }, block.node, block.pos, editor, tr, { trackChange });
     dispatchEditorTransaction$1(editor, tr);
     clearIndexCache(editor);
     return true;
@@ -254212,11 +254437,17 @@ function tablesSetShadingAdapter(editor, input2, options) {
       color: "auto"
     };
     const syncAttrs = resolved.scope === "table" ? syncExtractedTableAttrs(currentProps) : {};
-    tr.setNodeMarkup(resolved.pos, null, {
+    const nextAttrs = {
       ...currentAttrs,
       [propsKey]: currentProps,
       ...syncAttrs
-    });
+    };
+    if (resolved.scope === "cell")
+      if (normalizedColor === "auto")
+        delete nextAttrs.background;
+      else
+        nextAttrs.background = { color: normalizedColor };
+    tr.setNodeMarkup(resolved.pos, null, nextAttrs);
     if (resolved.scope === "table")
       applyShadingToCells(tr, resolved.node, resolved.pos + 1, normalizedColor);
     applyDirectMutationMeta(tr);
@@ -254243,11 +254474,14 @@ function tablesClearShadingAdapter(editor, input2, options) {
     const currentProps = { ...currentAttrs[propsKey] ?? {} };
     delete currentProps.shading;
     const syncAttrs = resolved.scope === "table" ? syncExtractedTableAttrs(currentProps) : {};
-    tr.setNodeMarkup(resolved.pos, null, {
+    const nextAttrs = {
       ...currentAttrs,
       [propsKey]: currentProps,
       ...syncAttrs
-    });
+    };
+    if (resolved.scope === "cell")
+      delete nextAttrs.background;
+    tr.setNodeMarkup(resolved.pos, null, nextAttrs);
     if (resolved.scope === "table") {
       const tableNode = resolved.node;
       const tableStart = resolved.pos + 1;
@@ -255290,7 +255524,7 @@ function registerBuiltInExecutors() {
   registerStepExecutor("text.delete", { execute: (ctx$1, targets, step3) => executeTextStep(ctx$1, targets, step3, (e, tr, t, s2, m$1) => executeTextDelete(e, tr, t, s2, m$1), (e, tr, t, s2, m$1) => executeSpanTextDelete(e, tr, t, s2, m$1)) });
   registerStepExecutor("format.apply", { execute: (ctx$1, targets, step3) => {
     ensureFormatStepCapabilities(ctx$1, step3);
-    return executeTextStep(ctx$1, targets, step3, (e, tr, t, s2, m$1) => executeStyleApply3(e, tr, t, s2, m$1), (e, tr, t, s2, m$1) => executeSpanStyleApply(e, tr, t, s2, m$1));
+    return executeTextStep(ctx$1, targets, step3, (e, tr, t, s2, m$1) => executeStyleApply3(e, tr, t, s2, m$1, ctx$1.changeMode), (e, tr, t, s2, m$1) => executeSpanStyleApply(e, tr, t, s2, m$1, ctx$1.changeMode));
   } });
   registerStepExecutor("create.paragraph", { execute: (ctx$1, targets, step3) => executeCreateStep(ctx$1.editor, ctx$1.tr, step3, targets, ctx$1.mapping) });
   registerStepExecutor("create.heading", { execute: (ctx$1, targets, step3) => executeCreateStep(ctx$1.editor, ctx$1.tr, step3, targets, ctx$1.mapping) });
@@ -296991,11 +297225,12 @@ var Node$13 = class Node$14 {
   return buildGraphFromSpans({
     spans: enumerateTrackedMarkSpans(state),
     structuralChanges: enumerateStructuralRowChanges(state),
+    pprChanges: enumeratePprChanges(state),
     doc: state?.doc ?? null,
     story,
     replacementsMode
   });
-}, buildGraphFromSpans = ({ spans, structuralChanges = [], doc: doc$12, story, replacementsMode }) => {
+}, buildGraphFromSpans = ({ spans, structuralChanges = [], pprChanges = [], doc: doc$12, story, replacementsMode }) => {
   const mergedSegments = mergeAdjacentSpans(spans.map((span) => ({
     attrs: readTrackedAttrs(span.mark, span.mark.type.name),
     span
@@ -297073,6 +297308,22 @@ var Node$13 = class Node$14 {
     mergedSegments.push(...logical.segments);
     appendToMap(byRevisionGroupId, logical.revisionGroupId, logical.id);
   }
+  for (const ppr of pprChanges) {
+    const logical = buildPprLogicalChange({
+      ppr,
+      doc: doc$12,
+      story
+    });
+    if (!logical)
+      continue;
+    const internalKey = `pprchange:${ppr.from}`;
+    if (changes.has(internalKey))
+      continue;
+    changes.set(internalKey, logical);
+    if (logical.id && logical.id !== internalKey && !changes.has(logical.id))
+      changes.set(logical.id, logical);
+    appendToMap(byRevisionGroupId, logical.revisionGroupId, logical.id);
+  }
   const segments = mergedSegments.slice().sort((a2, b$1) => a2.from - b$1.from || a2.to - b$1.to);
   const graph = {
     changes,
@@ -297185,6 +297436,12 @@ var Node$13 = class Node$14 {
     type = CanonicalChangeType.Formatting;
   else
     type = "";
+  if (type === CanonicalChangeType.Replacement && !(inserted.length && deleted.length)) {
+    if (inserted.length)
+      type = CanonicalChangeType.Insertion;
+    else if (deleted.length)
+      type = CanonicalChangeType.Deletion;
+  }
   const subtype = subtypeFromChangeType(type) ?? "";
   const primary = segments[0]?.attrs ?? null;
   let replacement = null;
@@ -297321,6 +297578,90 @@ var Node$13 = class Node$14 {
     enumerable: false
   });
   return logical;
+}, buildPprLogicalChange = ({ ppr, doc: doc$12, story }) => {
+  const from$1 = ppr.from;
+  const to = ppr.to;
+  if (!(from$1 < to))
+    return null;
+  const side = SegmentSide.Formatting;
+  const attrs = {
+    id: ppr.id,
+    revisionGroupId: ppr.id,
+    splitFromId: "",
+    changeType: CanonicalChangeType.Formatting,
+    replacementGroupId: "",
+    replacementSideId: "",
+    overlapParentId: "",
+    sourceIds: {},
+    sourceId: "",
+    importedAuthor: "",
+    origin: "",
+    author: ppr.author,
+    authorId: "",
+    authorEmail: ppr.authorEmail,
+    authorImage: ppr.authorImage,
+    date: ppr.date,
+    markType: "",
+    side,
+    subtype: ppr.subtype,
+    explicitChangeType: CanonicalChangeType.Formatting,
+    hasReviewMetadata: true
+  };
+  const segment = {
+    segmentId: `${ppr.id}:pprchange:${from$1}:${to}:0`,
+    changeId: ppr.id,
+    markType: "",
+    side,
+    from: from$1,
+    to,
+    text: "",
+    mark: null,
+    markRuns: [],
+    attrs,
+    parentId: "",
+    parentSide: "",
+    overlapRole: "standalone",
+    pprChange: true
+  };
+  if (doc$12)
+    try {
+      segment.text = doc$12.textBetween(from$1, to, " ", "");
+    } catch {
+      segment.text = "";
+    }
+  const segments = [segment];
+  const logical = {
+    id: ppr.id,
+    type: CanonicalChangeType.Formatting,
+    subtype: ppr.subtype,
+    state: "open",
+    segments,
+    coverageSegments: [...segments],
+    insertedSegments: [],
+    deletedSegments: [],
+    formattingSegments: [...segments],
+    replacement: null,
+    author: ppr.author,
+    authorId: "",
+    authorEmail: ppr.authorEmail,
+    authorImage: ppr.authorImage,
+    date: ppr.date,
+    sourceIds: {},
+    revisionGroupId: ppr.id,
+    splitFromId: "",
+    sourcePlatform: "",
+    story,
+    parent: null,
+    children: [],
+    before: [],
+    after: [],
+    excerpt: segment.text.length > 200 ? `${segment.text.slice(0, 200)}…` : segment.text
+  };
+  Object.defineProperty(logical, "pprChange", {
+    value: ppr,
+    enumerable: false
+  });
+  return logical;
 }, aggregateSourceIds = (segments) => {
   const out = {};
   const sorted = [...segments].sort((a2, b$1) => {
@@ -300035,6 +300376,10 @@ var Node$13 = class Node$14 {
     touchedChangeIds: applyResult.touchedChangeIds,
     diagnostics: plan.diagnostics
   };
+}, normalizeReplacementSide = (value) => {
+  if (value === SegmentSide.Inserted || value === SegmentSide.Deleted)
+    return value;
+  return null;
 }, normalizeDecisionTarget = (target) => {
   if (!target || typeof target !== "object")
     return {
@@ -300048,11 +300393,18 @@ var Node$13 = class Node$14 {
         ok: false,
         failure: failure$3("INVALID_TARGET", 'target.kind = "id" requires a non-empty id.')
       };
+    const side = normalizeReplacementSide(t.side);
+    if (t.side != null && !side)
+      return {
+        ok: false,
+        failure: failure$3("INVALID_TARGET", 'target.side must be "inserted" or "deleted" when provided.')
+      };
     return {
       ok: true,
       value: {
         kind: "id",
-        id: t.id
+        id: t.id,
+        ...side ? { side } : {}
       }
     };
   }
@@ -300156,7 +300508,8 @@ var Node$13 = class Node$14 {
         ranges: change.segments.map((s2) => ({
           from: s2.from,
           to: s2.to
-        }))
+        })),
+        ...normalized.side ? { side: normalized.side } : {}
       }]
     };
   }
@@ -300399,7 +300752,7 @@ var Node$13 = class Node$14 {
       suppressedInsideTable.add(change.id);
       continue;
     }
-    if (isInsideStayingTable(change)) {
+    if (!change.pprChange && isInsideStayingTable(change)) {
       const failureResult = planContainedInlineChild(change);
       if (failureResult)
         return {
@@ -300408,6 +300761,36 @@ var Node$13 = class Node$14 {
         };
       continue;
     }
+    if (change.type === CanonicalChangeType.Replacement && selection.side) {
+      touched.add(change.id);
+      const sideResult = planReplacementSideDecision({
+        ops,
+        change,
+        decision,
+        side: selection.side,
+        removedRanges,
+        retired,
+        resolvedRanges
+      });
+      if (!sideResult.ok)
+        return {
+          ok: false,
+          failure: sideResult.failure
+        };
+      continue;
+    }
+    if (selection.side) {
+      const standaloneSide = change.type === CanonicalChangeType.Insertion ? "inserted" : change.type === CanonicalChangeType.Deletion ? "deleted" : null;
+      if (standaloneSide !== selection.side)
+        return {
+          ok: false,
+          failure: failure$3("INVALID_TARGET", `target.side "${selection.side}" does not apply: this change is not a paired replacement${standaloneSide ? ` (its only side is "${standaloneSide}")` : ""}. The targeted side may have already been resolved.`, { details: {
+            changeId: change.id,
+            requestedSide: selection.side,
+            currentSide: standaloneSide
+          } })
+        };
+    }
     const isFull = selection.coverage === "full";
     if (!isFull) {
       if (change.type === CanonicalChangeType.Structural)
@@ -300430,14 +300813,26 @@ var Node$13 = class Node$14 {
         };
     }
     touched.add(change.id);
-    if (isFull)
+    if (isFull && !change.pprChange)
       for (const segment of change.segments)
         resolvedRanges.push({
           from: segment.from,
           to: segment.to,
           cause: `${decision}:${change.id}`
         });
-    if (change.type === CanonicalChangeType.Structural) {
+    if (change.pprChange) {
+      const pprResult = planPprDecision({
+        ops,
+        change,
+        decision,
+        retired
+      });
+      if (!pprResult.ok)
+        return {
+          ok: false,
+          failure: pprResult.failure
+        };
+    } else if (change.type === CanonicalChangeType.Structural) {
       const structuralResult = planStructuralDecision({
         ops,
         change,
@@ -300522,6 +300917,22 @@ var Node$13 = class Node$14 {
         continue;
       if (!isInsideStayingTable(change))
         continue;
+      if (change.pprChange) {
+        cascadedInsideStayingTable.add(change.id);
+        touched.add(change.id);
+        const pprResult = planPprDecision({
+          ops,
+          change,
+          decision,
+          retired
+        });
+        if (!pprResult.ok)
+          return {
+            ok: false,
+            failure: pprResult.failure
+          };
+        continue;
+      }
       const failureResult = planContainedInlineChild(change);
       if (failureResult)
         return {
@@ -300706,6 +301117,22 @@ var Node$13 = class Node$14 {
     });
   retired.add(change.id);
   return { ok: true };
+}, planPprDecision = ({ ops, change, decision, retired }) => {
+  const ppr = change.pprChange;
+  if (!ppr)
+    return {
+      ok: false,
+      failure: failure$3("CAPABILITY_UNAVAILABLE", `change "${change.id}" is not a paragraph-property change.`)
+    };
+  ops.push({
+    kind: "resolvePprChange",
+    from: ppr.from,
+    changeId: change.id,
+    decision,
+    formerProperties: ppr.formerProperties
+  });
+  retired.add(change.id);
+  return { ok: true };
 }, planReplacementDecision = ({ ops, graph, change, decision, removedRanges, retired }) => {
   const inserted = change.insertedSegments;
   const deleted = change.deletedSegments;
@@ -300790,6 +301217,55 @@ var Node$13 = class Node$14 {
   }
   retired.add(change.id);
   return { ok: true };
+}, planReplacementSideDecision = ({ ops, change, decision, side, removedRanges, resolvedRanges }) => {
+  const inserted = change.insertedSegments;
+  const deleted = change.deletedSegments;
+  if (!inserted.length || !deleted.length)
+    return {
+      ok: false,
+      failure: failure$3("PRECONDITION_FAILED", `replacement "${change.id}" missing inserted or deleted side.`)
+    };
+  const segments = side === SegmentSide.Inserted ? inserted : deleted;
+  for (const seg of segments)
+    resolvedRanges.push({
+      from: seg.from,
+      to: seg.to,
+      cause: `${decision}-replacement-${side}:${change.id}`
+    });
+  const removeContent = (seg, cause) => {
+    ops.push({
+      kind: "removeContent",
+      from: seg.from,
+      to: seg.to,
+      changeId: change.id,
+      side
+    });
+    removedRanges.push({
+      from: seg.from,
+      to: seg.to,
+      cause: `${cause}:${change.id}`
+    });
+  };
+  const dropMark = (seg) => pushRemoveMarkOpsForSegment({
+    ops,
+    segment: seg,
+    changeId: change.id,
+    side
+  });
+  if (side === SegmentSide.Deleted)
+    if (decision === "accept")
+      for (const seg of deleted)
+        removeContent(seg, "accept-replacement-deleted-side");
+    else
+      for (const seg of deleted)
+        dropMark(seg);
+  else if (decision === "accept")
+    for (const seg of inserted)
+      dropMark(seg);
+  else
+    for (const seg of inserted)
+      removeContent(seg, "reject-replacement-inserted-side");
+  return { ok: true };
 }, getParentRestoreContext = ({ graph, change }) => {
   const explicit = getExplicitParentRestoreContext({
     graph,
@@ -301158,6 +301634,31 @@ var Node$13 = class Node$14 {
           });
         continue;
       }
+      if (op.kind === "resolvePprChange") {
+        const mappedFrom = tr.mapping.map(op.from, 1);
+        const node3 = tr.doc.nodeAt(mappedFrom);
+        const pp = node3?.attrs?.paragraphProperties;
+        if (node3 && pp && pp.change)
+          if (op.decision === "accept") {
+            const kept = { ...pp };
+            delete kept.change;
+            tr.setNodeMarkup(mappedFrom, undefined, {
+              ...node3.attrs,
+              paragraphProperties: kept
+            });
+          } else {
+            const former = { ...op.formerProperties || {} };
+            const nextAttrs = {
+              ...node3.attrs,
+              paragraphProperties: former,
+              numberingProperties: former.numberingProperties ?? null
+            };
+            if (!former.numberingProperties)
+              nextAttrs.listRendering = null;
+            tr.setNodeMarkup(mappedFrom, undefined, nextAttrs);
+          }
+        continue;
+      }
     }
     for (const op of contentOps)
       tr.step(new ReplaceStep(op.from, op.to, Slice.empty));
@@ -327366,13 +327867,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_bMRzO9Kl_es = __esm(() => {
+var init_src_Dra6R0wc_es = __esm(() => {
   init_rolldown_runtime_Bg48TavK_es();
-  init_SuperConverter_Ed3nFN54_es();
+  init_SuperConverter_DlrS7cQT_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
   init_uuid_B2wVPhPi_es();
-  init_create_headless_toolbar_PSeH6IV5_es();
+  init_create_headless_toolbar_0mIJ8_xU_es();
   init_constants_D9qj59G2_es();
   init_unified_BDuVPlMu_es();
   init_remark_gfm_BUJjZJLy_es();
@@ -327801,7 +328302,7 @@ var init_src_bMRzO9Kl_es = __esm(() => {
     },
     "blocks.list": {
       memberPath: "blocks.list",
-      description: "List top-level blocks in document order with IDs, types, text previews, and optional full text when includeText:true. Supports pagination via offset/limit, optional nodeType filtering, and single-story scoping via `in: <StoryLocator>`.",
+      description: "List top-level blocks in document order with IDs, types, text previews, and optional full text when includeText:true. Text, previews, lengths, and formatting hints use the VISIBLE model: pending tracked deletions are excluded (matching how edit refs resolve), and inline atoms render as a single placeholder character. Supports pagination via offset/limit, optional nodeType filtering, and single-story scoping via `in: <StoryLocator>`.",
       expectedResult: "Returns a BlocksListResult with total block count, an ordered array of block entries (ordinal, nodeId, nodeType, textPreview, optional text, isEmpty), and the current document revision.",
       requiresDocumentContext: true,
       metadata: readOperation2({ throws: ["INVALID_INPUT", ...T_STORY2] }),
@@ -328740,13 +329241,13 @@ var init_src_bMRzO9Kl_es = __esm(() => {
     },
     "lists.attach": {
       memberPath: "lists.attach",
-      description: "Convert non-list paragraphs to list items under an existing list sequence.",
+      description: 'Convert non-list paragraphs to list items under an existing list sequence. With changeMode:"tracked" the former (unnumbered) paragraph properties are recorded as a w:pPrChange so a reviewer can accept/reject the numbering.',
       expectedResult: "Returns a ListsMutateItemResult confirming attachment.",
       requiresDocumentContext: true,
       metadata: mutationOperation2({
         idempotency: "conditional",
         supportsDryRun: true,
-        supportsTrackedMode: false,
+        supportsTrackedMode: true,
         possibleFailureCodes: ["INVALID_TARGET", "NO_OP"],
         throws: [...T_NOT_FOUND_CAPABLE2, "INVALID_TARGET"]
       }),
@@ -351346,7 +351847,7 @@ function print() { __p += __j.call(arguments, '') }
             })
           });
         },
-        acceptTrackedChangeById: (id2) => ({ state, dispatch, editor }) => {
+        acceptTrackedChangeById: (id2, options = {}) => ({ state, dispatch, editor }) => {
           return dispatchReviewDecision({
             editor,
             state,
@@ -351354,7 +351855,8 @@ function print() { __p += __j.call(arguments, '') }
             decision: "accept",
             target: {
               kind: "id",
-              id: id2
+              id: id2,
+              ...options.side ? { side: options.side } : {}
             }
           }).applied;
         },
@@ -351367,7 +351869,7 @@ function print() { __p += __j.call(arguments, '') }
             target: { kind: "all" }
           }).applied;
         },
-        rejectTrackedChangeById: (id2) => ({ state, dispatch, editor }) => {
+        rejectTrackedChangeById: (id2, options = {}) => ({ state, dispatch, editor }) => {
           return dispatchReviewDecision({
             editor,
             state,
@@ -351375,7 +351877,8 @@ function print() { __p += __j.call(arguments, '') }
             decision: "reject",
             target: {
               kind: "id",
-              id: id2
+              id: id2,
+              ...options.side ? { side: options.side } : {}
             }
           }).applied;
         },
@@ -370677,11 +371180,11 @@ function print() { __p += __j.call(arguments, '') }
   ]);
 });
 
-// ../../packages/superdoc/dist/chunks/create-super-doc-ui-DNNbMZCp.es.js
+// ../../packages/superdoc/dist/chunks/create-super-doc-ui-BNkolmSw.es.js
 var DEFAULT_TEXT_ALIGN_OPTIONS, DEFAULT_LINE_HEIGHT_OPTIONS, DEFAULT_ZOOM_OPTIONS, DEFAULT_DOCUMENT_MODE_OPTIONS, DEFAULT_FONT_SIZE_OPTIONS, headlessToolbarConstants, 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, FONT_SIZE_OPTIONS;
-var init_create_super_doc_ui_DNNbMZCp_es = __esm(() => {
-  init_SuperConverter_Ed3nFN54_es();
-  init_create_headless_toolbar_PSeH6IV5_es();
+var init_create_super_doc_ui_BNkolmSw_es = __esm(() => {
+  init_SuperConverter_DlrS7cQT_es();
+  init_create_headless_toolbar_0mIJ8_xU_es();
   DEFAULT_TEXT_ALIGN_OPTIONS = [
     {
       label: "Left",
@@ -370972,15 +371475,15 @@ var init_zipper_BxRAi0_5_es = __esm(() => {
 
 // ../../packages/superdoc/dist/super-editor.es.js
 var init_super_editor_es = __esm(() => {
-  init_src_bMRzO9Kl_es();
-  init_SuperConverter_Ed3nFN54_es();
+  init_src_Dra6R0wc_es();
+  init_SuperConverter_DlrS7cQT_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
-  init_create_headless_toolbar_PSeH6IV5_es();
+  init_create_headless_toolbar_0mIJ8_xU_es();
   init_constants_D9qj59G2_es();
   init_unified_BDuVPlMu_es();
   init_DocxZipper_BzS208BW_es();
-  init_create_super_doc_ui_DNNbMZCp_es();
+  init_create_super_doc_ui_BNkolmSw_es();
   init_ui_CGB3qmy3_es();
   init_eventemitter3_UwU_CLPU_es();
   init_errors_C_DoKMoN_es();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli",
-  "version": "0.17.0-next.44",
+  "version": "0.17.0-next.46",
   "type": "module",
   "bin": {
     "superdoc": "./dist/index.js"
@@ -26,8 +26,8 @@
     "lib0": "^0.2.114",
     "typescript": "^5.9.2",
     "y-protocols": "^1.0.6",
-    "@superdoc/document-api": "0.1.0-alpha.0",
     "@superdoc/super-editor": "0.0.1",
+    "@superdoc/document-api": "0.1.0-alpha.0",
     "superdoc": "1.43.1"
   },
   "module": "src/index.ts",
@@ -35,11 +35,11 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@superdoc-dev/cli-darwin-arm64": "0.17.0-next.44",
-    "@superdoc-dev/cli-darwin-x64": "0.17.0-next.44",
-    "@superdoc-dev/cli-linux-x64": "0.17.0-next.44",
-    "@superdoc-dev/cli-linux-arm64": "0.17.0-next.44",
-    "@superdoc-dev/cli-windows-x64": "0.17.0-next.44"
+    "@superdoc-dev/cli-darwin-arm64": "0.17.0-next.46",
+    "@superdoc-dev/cli-darwin-x64": "0.17.0-next.46",
+    "@superdoc-dev/cli-linux-x64": "0.17.0-next.46",
+    "@superdoc-dev/cli-linux-arm64": "0.17.0-next.46",
+    "@superdoc-dev/cli-windows-x64": "0.17.0-next.46"
   },
   "scripts": {
     "predev": "node scripts/ensure-superdoc-build.js",