@superdoc/mcp 1.9.0-next.10 → 1.9.0-next.11

package/dist/index.js

@@ -31620,7 +31620,7 @@ var init_host = __esm(() => {
 });
 
 // ../../packages/sdk/langs/node/src/runtime/sdk-version.generated.ts
-var SDK_VERSION = "2.22.0-next.10";
+var SDK_VERSION = "2.22.0-next.11";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { accessSync, chmodSync, constants, existsSync, statSync } from "node:fs";
@@ -186198,7 +186198,7 @@ function captureCooperativeTrackedCatalogRead(state, mode, assertActive) {
     numberingCatalog: listContext.numberingCatalog,
     styleNumberingIndex: listContext.styleIndex,
     stylesStatus: listContext.stylesStatus,
-    textboxRegistryRecords: state.textboxRegistry.records
+    textboxRegistryRecords: Array.from(state.textboxRegistry.records)
   });
   let released = false, building = false;
   const check2 = () => {
@@ -314315,6 +314315,7 @@ function computeFieldResult(context, instruction, options = {}) {
   }
   switch (keyword) {
     case "PAGE":
+      return resolvePageFieldText(context, options.currentField ?? options.pageLocation, instruction);
     case "PAGEREF":
       return resolvePageFieldText(context, options.currentField);
     case "NUMPAGES":
@@ -315934,32 +315935,60 @@ function readPreservedTocPageByText(preserved, text) {
 function normalizeGeneratedTocHeadingText(text) {
   return text.replace(/[\r\n\t]+/g, " ").replace(/\s+/g, " ").trim();
 }
-function resolvePageFieldText(context, currentField) {
+function resolvePageFieldText(context, currentField, instruction) {
+  const format = (page, sectionFormat) => instruction == null ? String(page) : formatPageFieldNumber(page, instruction, sectionFormat);
   if (!currentField)
-    return "1";
+    return format(1);
   const pages = estimateDocumentPages(context);
   if (!currentField.storyId.startsWith("header:") && !currentField.storyId.startsWith("footer:")) {
-    return String(pages.displayPageByBlockId.get(currentField.blockId) ?? 1);
+    return format(pages.displayPageByBlockId.get(currentField.blockId) ?? 1, pages.numberFormatByBlockId.get(currentField.blockId));
   }
   const snapshot2 = getSDDocumentSessionInternalSourceSignalsSnapshot(context.session);
   const main = snapshot2?.stories.find((story) => story.storyKind === "main");
   if (!main)
-    return "1";
+    return format(1);
   const kind = currentField.storyId.startsWith("header:") ? "header" : "footer";
   const liveSections = readLiveSectionSignals(context);
   const rel = listSDDocumentSessionInternalHeaderFooterRels(context.session).find((candidate2) => candidate2.partUri === currentField.partUri);
   if (!rel)
-    return "1";
+    return format(1);
   for (const section of liveSections) {
     const ref5 = section.headerFooterRefs.find((candidate2) => candidate2.kind === kind && candidate2.relationshipId === rel.refId);
     if (!ref5)
       continue;
     const sectionPages = pages.sectionById.get(section.sectionId);
     if (!sectionPages)
-      return "1";
-    return String(sectionPages.startDisplayPage + headerFooterPageOffset(ref5.variant, sectionPages.startDisplayPage, sectionPages.pageCount, sectionPages.titlePage, sectionPages.pageNumberingMode));
+      return format(1);
+    return format(sectionPages.startDisplayPage + headerFooterPageOffset(ref5.variant, sectionPages.startDisplayPage, sectionPages.pageCount, sectionPages.titlePage, sectionPages.pageNumberingMode), section.pageNumbering.format);
+  }
+  return format(1);
+}
+function formatPageFieldNumber(page, instruction, sectionFormat) {
+  let format = sectionFormat ?? "decimal";
+  for (const match of instruction.matchAll(/(?:^|\s)\\\*\s*(?:"([^"]*)"|([^\s"]+))/g)) {
+    const value2 = match[1] ?? match[2];
+    switch (value2.toLowerCase()) {
+      case "roman":
+        format = value2[0] === "r" ? "lowerRoman" : "upperRoman";
+        break;
+      case "alphabetic":
+        format = value2[0] === "a" ? "lowerLetter" : "upperLetter";
+        break;
+      case "arabic":
+        format = "decimal";
+        break;
+      case "arabicdash":
+        format = "numberInDash";
+        break;
+    }
   }
-  return "1";
+  if (format === "numberInDash")
+    return `- ${page} -`;
+  if ((format === "upperLetter" || format === "lowerLetter") && page > 0) {
+    const letter = String.fromCharCode(65 + (page - 1) % 26).repeat(Math.floor((page - 1) / 26) + 1);
+    return format === "lowerLetter" ? letter.toLowerCase() : letter;
+  }
+  return formatNumberingOrdinal(page, format);
 }
 function headerFooterPageOffset(variant, startDisplayPage, pageCount, titlePage, pageNumberingMode = "unknown") {
   const firstBodyPageOffset = titlePage && pageCount > 1 && (pageNumberingMode === "restart" || pageNumberingMode === "invalid") ? 1 : 0;
@@ -315977,11 +316006,12 @@ function headerFooterPageOffset(variant, startDisplayPage, pageCount, titlePage,
 function estimateDocumentPages(context) {
   const physicalPageByBlockId = new Map;
   const displayPageByBlockId = new Map;
+  const numberFormatByBlockId = new Map;
   const sectionById = new Map;
   const snapshot2 = getSDDocumentSessionInternalSourceSignalsSnapshot(context.session);
   const main = snapshot2?.stories.find((story) => story.storyKind === "main");
   if (!main)
-    return { physicalPageByBlockId, displayPageByBlockId, sectionById };
+    return { physicalPageByBlockId, displayPageByBlockId, numberFormatByBlockId, sectionById };
   const sections = readLiveSectionSignals(context);
   const liveBody = readLiveBodyPageSignals(context);
   const paragraphOrdinals = main.paragraphIndex.map((signal, index) => ({
@@ -316018,9 +316048,10 @@ function estimateDocumentPages(context) {
       const priorBreaks = breaksInSection.filter((entry) => entry.bodyChildOrdinal < paragraph2.ordinal || entry.bodyChildOrdinal === paragraph2.ordinal && entry.source === "paragraph-page-break-before").length;
       physicalPageByBlockId.set(paragraph2.blockId, startPhysicalPage + priorBreaks);
       displayPageByBlockId.set(paragraph2.blockId, startDisplayPage + priorBreaks);
+      numberFormatByBlockId.set(paragraph2.blockId, section.pageNumbering.format);
     }
   }
-  return { physicalPageByBlockId, displayPageByBlockId, sectionById };
+  return { physicalPageByBlockId, displayPageByBlockId, numberFormatByBlockId, sectionById };
 }
 function readLiveBodyPageSignals(context) {
   const documentBytes = getSDDocumentSessionInternalPartBytes(context.session, "/word/document.xml");
@@ -379066,8 +379097,17 @@ class V2TrackedChangesAdapter {
         items: [],
         unresolvedTrackedChangeIds: [...new Set(requestedIds)]
       };
-    const sourceFilter = source && { ...source, structuralScope: structuralScope ?? undefined };
     const resolveSession = createTrackedChangeFragmentResolveSession();
+    const range = source?.textRange;
+    const validTextRange = range && Number.isSafeInteger(range.start) && Number.isSafeInteger(range.end) && range.start >= 0 && range.end > range.start;
+    const sourceFilter = source && {
+      ...source,
+      structuralScope: structuralScope ?? undefined,
+      matchesTextFragment: validTextRange ? (fragment4) => {
+        const resolved = resolveTrackedChangeFragmentTextTarget(this.context, fragment4, "tracked", story, resolveSession);
+        return resolved.ok && resolved.normalizedTarget.segments.some((segment) => segment.blockId === range.blockId && segment.range.start <= range.start && range.end <= segment.range.end);
+      } : undefined
+    };
     const seenInput = new Set;
     const seenCanonical = new Set;
     const orderedRequestedIds = [];
@@ -382043,6 +382083,11 @@ function resolveReviewSnapshotOwner(logical, entry) {
 function reviewSnapshotEntryMatchesSource(entry, source, requestedId) {
   if (source?.partUri && entry.partUri !== source.partUri)
     return false;
+  if (source?.textRange) {
+    const aliases = requestedId ? reviewSnapshotRequestedIdAliases(requestedId) : [];
+    if (!entry.fragments.some((fragment4) => (requestedId === entry.id || aliases.includes(fragment4.wId) || aliases.includes(fragment4.rsid)) && (source.kind === "insert" ? fragment4.kind === "ins" || fragment4.kind === "moveTo" : source.kind === "delete" ? fragment4.kind === "del" || fragment4.kind === "moveFrom" : false) && source.matchesTextFragment?.(fragment4)))
+      return false;
+  }
   if (source?.structuralScope) {
     const scope = source.structuralScope;
     const aliases = requestedId ? reviewSnapshotRequestedIdAliases(requestedId) : [];
@@ -389529,15 +389574,16 @@ class V2FieldsAdapter {
     const resolved = resolveInsertTarget(this.context, input.at, options);
     if ("failure" in resolved)
       return mutationFailure2(resolved.failure.code, resolved.failure.message);
+    const paragraph4 = findParagraphInStory(this.context, resolved.range.storyId, resolved.range.startBlockId);
+    if (!paragraph4)
+      return mutationFailure2("TARGET_NOT_FOUND", `Paragraph "${resolved.range.startBlockId}" was not found.`);
     const beforeFieldEntries = listCanonicalFieldEntries(this.context);
     const beforeFieldIds = new Set(beforeFieldEntries.map((entry) => entry.stableFieldId));
     const preserveCached = input.updatePolicy === "preserveCached" && typeof input.cachedResultText === "string";
     const resultText = preserveCached ? input.cachedResultText : computeFieldResult(this.context, input.instruction, {
+      pageLocation: paragraph4,
       seqFallbackLabel: parseSeqFallbackLabel(input.instruction)
     });
-    const paragraph4 = findParagraphInStory(this.context, resolved.range.storyId, resolved.range.startBlockId);
-    if (!paragraph4)
-      return mutationFailure2("TARGET_NOT_FOUND", `Paragraph "${resolved.range.startBlockId}" was not found.`);
     const selectedText = paragraph4.text.slice(resolved.range.startOffset, resolved.range.endOffset);
     const replaceSelection = resolved.range.endOffset > resolved.range.startOffset && selectedText === resultText;
     let fieldXml = preserveCached ? buildPreservedCachedFieldXml(input.instruction, resultText) : options?.changeMode === "tracked" ? buildComplexFieldTextXml(input.instruction, resultText) : buildSimpleFieldXml(input.instruction, resultText);
@@ -478713,6 +478759,9 @@ function createHeadlessCollabRoomCoordinator(options) {
   let syncingManifest = false;
   let registryChangedDuringSync = false;
   let packageParts = getPackagePartsMap(options.rootDoc);
+  const numberingPartKey = encodeLogicalOwnerKey(NUMBERING_PART_URI7);
+  const numberingShardId = packageShardId(options.rootId, SHARD_KIND.numbering, NUMBERING_PART_URI7);
+  let numberingDeletionObserved = false;
   const meta3 = getMetaMap(options.rootDoc);
   const packageSelection = options.rootDoc.getMap(ROOT_MAP.package);
   const observedReplacements = new Set;
@@ -478727,9 +478776,19 @@ function createHeadlessCollabRoomCoordinator(options) {
     return changed;
   }
   observeReplacementCommits();
-  const manifestObserver = () => {
+  const manifestObserver = (event) => {
     if (disposed)
       return;
+    if (event.target === packageParts) {
+      for (const [partKey2, change] of event.changes.keys) {
+        if (change.action !== "delete")
+          continue;
+        const previous3 = toManifestPartDescriptor(partKey2, change.oldValue);
+        if (previous3?.partKind === "numbering" && previous3.partUri === NUMBERING_PART_URI7 && partKey2 === numberingPartKey) {
+          numberingDeletionObserved = true;
+        }
+      }
+    }
     const replacementCommitted = observeReplacementCommits();
     if (replacementCommitted)
       pruneReplacedRoomOrphans(options.rootDoc);
@@ -479876,7 +479935,8 @@ function createHeadlessCollabRoomCoordinator(options) {
     for (const [shardId, handle] of options.graph.projectionHandles.entries()) {
       if (activeShardIds.has(shardId))
         continue;
-      if (!replacingPackage && !isManifestPrunableProjectionHandle(handle))
+      const explicitlyRetiredNumbering = handle.shardKind === SHARD_KIND.numbering && shardId === numberingShardId && numberingDeletionObserved;
+      if (!replacingPackage && !explicitlyRetiredNumbering && !isManifestPrunableProjectionHandle(handle))
         continue;
       options.graph.projectionHandles.delete(shardId);
       options.graph.requiredShardIds.delete(shardId);
@@ -479884,6 +479944,7 @@ function createHeadlessCollabRoomCoordinator(options) {
         options.graph.commentsHandle = null;
       changed = true;
     }
+    numberingDeletionObserved = false;
     if (changed)
       notifyRegistryChangedIfActive();
   }

package/package.json

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