@superdoc/sdk 2.19.0-next.3 → 2.19.0-next.4

package/README.md

@@ -96,6 +96,26 @@ if (matches.total === 1) {
 }
 ```
 
+## Tracked comparison with direct style definitions
+
+For standalone V2 comparisons, `styleChangeMode: 'direct'` lets you explicitly
+carry the target style definitions while applying body edits as tracked changes:
+
+```js
+const diff = await older.diff.compare({ targetSnapshot, styleChangeMode: 'direct' });
+const result = await older.diff.apply({ diff, changeMode: 'tracked', styleChangeMode: 'direct' });
+console.log(result.styleChanges); // { changeMode: 'direct', partUris: [...] }, when styles changed
+await older.save({ out: 'comparison.docx' });
+```
+
+Set the policy on both calls: compare reports eligibility for that policy;
+apply requires its own explicit consent. Style definitions are applied directly
+and remain if the body revisions are rejected in Word. A style-only comparison
+creates no body revisions. Without this option, changed style definitions still
+block tracked apply. Unsupported numbering, settings, and other package changes
+retain their existing restrictions. Suggest-only versioned review sessions
+refuse this direct-style option.
+
 ## Tracked comparison with exact-file review
 
 The SDK's `diff.capture` and `diff.compare` describe a snapshot comparison. A

package/dist/generated/client.d.ts

@@ -30733,6 +30733,7 @@ export interface DocDiffCompareParams {
         };
         payload: Record<string, unknown>;
     };
+    styleChangeMode?: string;
 }
 export interface DocDiffApplyParams {
     doc?: string;
@@ -30801,6 +30802,7 @@ export interface DocDiffApplyParams {
         }>;
         payload: Record<string, unknown>;
     };
+    styleChangeMode?: string;
 }
 export interface DocExportToDocxParams {
     doc?: string;
@@ -103374,6 +103376,55 @@ export type DocSelectionCurrentResult = {
         });
         coordinateSpace?: "visible" | "tracked";
     }) | null;
+    tableSelection?: ({
+        kind: "tableCells";
+        type: "table" | "cell" | "cells";
+        tableId: string;
+        story?: ({
+            kind: "story";
+            storyType: "body";
+        }) | ({
+            kind: "story";
+            storyType: "headerFooterSlot";
+            section: {
+                kind: "section";
+                sectionId: string;
+            };
+            headerFooterKind: "header" | "footer";
+            variant: "default" | "first" | "even";
+            resolution?: "effective" | "explicit";
+            onWrite?: "materializeIfInherited" | "editResolvedPart" | "error";
+        }) | ({
+            kind: "story";
+            storyType: "headerFooterPart";
+            refId: string;
+        }) | ({
+            kind: "story";
+            storyType: "footnote";
+            noteId: string;
+        }) | ({
+            kind: "story";
+            storyType: "endnote";
+            noteId: string;
+        }) | ({
+            kind: "story";
+            storyType: "textbox";
+            textboxId: string;
+        });
+        start: {
+            rowIndex: number;
+            columnIndex: number;
+        };
+        end: {
+            rowIndex: number;
+            columnIndex: number;
+        };
+        cells: Array<{
+            nodeId: string;
+            rowIndex: number;
+            columnIndex: number;
+        }>;
+    }) | null;
     activeMarks: Array<string>;
     activeCommentIds: Array<string>;
     activeChangeIds: Array<string>;
@@ -122818,6 +122869,10 @@ export type DocDiffCompareResult = {
 };
 export type DocDiffApplyResult = {
     appliedOperations: number;
+    styleChanges?: {
+        changeMode: "direct";
+        partUris: Array<string>;
+    };
     operationReceipts: Array<({
         operationId: string;
         disposition: "review-created";
@@ -152904,6 +152959,7 @@ export interface DocDiffCompareBoundParams {
         };
         payload: Record<string, unknown>;
     };
+    styleChangeMode?: string;
 }
 export interface DocDiffApplyBoundParams {
     out?: string;
@@ -152970,6 +153026,7 @@ export interface DocDiffApplyBoundParams {
         }>;
         payload: Record<string, unknown>;
     };
+    styleChangeMode?: string;
 }
 export interface DocExportToDocxBoundParams {
     mode?: string;