superdoc 2.25.0-next.2 → 2.25.0-next.3

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.25.0-next.2",
+	superdocVersion: "2.25.0-next.3",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.25.0-next.2",
+	superdocVersion: "2.25.0-next.3",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/comments/comments.types.d.ts

@@ -216,6 +216,8 @@ export interface CommentsListQuery {
  */
 export interface CommentDomain {
     address: CommentAddress;
+    /** Canonical comment id alias returned by native runtimes. */
+    commentId?: string;
     /** See {@link CommentInfo.externalId}. */
     externalId?: string;
     /** See {@link CommentInfo.metadata}. */

package/dist/document-api/src/content-controls/content-controls.types.d.ts

@@ -1,7 +1,7 @@
 import { BlockNodeAddress, NodeKind } from '../types/base.js';
 import { SelectionTarget } from '../types/address.js';
 import { SDFragment } from '../types/fragment.js';
-import { ReceiptFailure, ReceiptInsert } from '../types/receipt.js';
+import { ReceiptFailure, ReceiptInsert, ReceiptSuccess } from '../types/receipt.js';
 import { StoryLocator } from '../types/story.types.js';
 /**
  * Semantic SDT subtype derived from `w:sdtPr` children.
@@ -154,11 +154,13 @@ export interface ContentControlInfo {
     /** Authoritative structural emptiness when the adapter can determine it. */
     isEmpty?: boolean;
 }
-export interface ContentControlMutationSuccess {
+export interface ContentControlMutationSuccess extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     contentControl: ContentControlTarget;
     updatedRef?: ContentControlTarget;
+    /** Identity of the block created by an adjacent-content insertion. */
+    createdBlockId?: string;
     affectedStories?: StoryLocator[];
     trackedChangeRefs?: ReceiptInsert[];
 }

package/dist/document-api/src/hyperlinks/hyperlinks.types.d.ts

@@ -1,7 +1,7 @@
 import { BlockNodeAddress, InlineNodeAddress } from '../types/base.js';
 import { TextAddress } from '../types/address.js';
 import { DiscoveryOutput } from '../types/discovery.js';
-import { ReceiptFailure } from '../types/receipt.js';
+import { ReceiptFailure, ReceiptSuccess } from '../types/receipt.js';
 /** Narrowed inline address for hyperlink targets. */
 export type HyperlinkTarget = InlineNodeAddress & {
     nodeType: 'hyperlink';
@@ -74,10 +74,17 @@ export interface HyperlinkInfo {
     properties: HyperlinkReadProperties;
     text?: string;
 }
-export interface HyperlinkMutationSuccess {
+export interface HyperlinkMutationSuccess extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     hyperlink: HyperlinkTarget;
+    /** Legacy native identifier for the mutated hyperlink, null after removal. */
+    hyperlinkNodeId?: string | null;
+    /** Package parts created or modified by the mutation. */
+    partsCreated?: readonly string[];
+    partsModified?: readonly string[];
+    /** Relationship identity created for an external destination, when present. */
+    createdRId?: string;
 }
 export interface HyperlinkMutationFailure {
     success: false;

package/dist/document-api/src/images/images.types.d.ts

@@ -1,5 +1,5 @@
 import { BlockNodeAddress } from '../types/index.js';
-import { ReceiptInsert } from '../types/receipt.js';
+import { ReceiptInsert, ReceiptSuccess } from '../types/receipt.js';
 import { StoryLocator } from '../types/story.types.js';
 import { ContentControlTarget } from '../content-controls/content-controls.types.js';
 import { ImageProperties, ImageWrapType, ImageWrapSide, ImageMarginOffset, ImageSize, ImageCropInfo } from '../types/media.types.js';
@@ -186,7 +186,7 @@ export interface SetZOrderInput {
     imageId: string;
     zOrder: ImageZOrderInput;
 }
-export interface CreateImageSuccessResult {
+export interface CreateImageSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     image: ImageAddress;
@@ -206,7 +206,7 @@ export interface ImagesListResult {
     total: number;
     items: ImageSummary[];
 }
-export interface ImagesMutationSuccessResult {
+export interface ImagesMutationSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     image: ImageAddress;

package/dist/document-api/src/lists/lists.types.d.ts

@@ -1,4 +1,4 @@
-import { AffectedRefRemapping, BlockNodeType, ReceiptFailure, ReceiptInsert, StoryLocator, TextAddress, TextRangeShift } from '../types/index.js';
+import { AffectedRefRemapping, BlockNodeType, ReceiptFailure, ReceiptInsert, ReceiptSuccess, StoryLocator, TextAddress, TextRangeShift } from '../types/index.js';
 import { DiscoveryOutput } from '../types/discovery.js';
 export type ListItemAddress = {
     kind: 'block';
@@ -356,14 +356,14 @@ export interface ListsCaptureTemplateSuccessResult {
     template: ListTemplate;
 }
 export type ListsCaptureTemplateResult = ListsCaptureTemplateSuccessResult | ListsFailureResult;
-export interface ListsInsertSuccessResult {
+export interface ListsInsertSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     item: ListItemAddress;
     insertionPoint: TextAddress;
     trackedChangeRefs?: ReceiptInsert[];
 }
-export interface ListsMutateItemSuccessResult {
+export interface ListsMutateItemSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     item: ListItemAddress;
@@ -375,38 +375,38 @@ export interface ListsMutateItemSuccessResult {
     txId?: string;
     changed?: boolean;
 }
-export interface ListsCreateSuccessResult {
+export interface ListsCreateSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     item: ListItemAddress;
 }
-export interface ListsJoinSuccessResult {
+export interface ListsJoinSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
 }
-export interface ListsSeparateSuccessResult {
+export interface ListsSeparateSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     numId: number;
 }
-export interface ListsMergeSuccessResult {
+export interface ListsMergeSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     absorbedCount: number;
     removedEmptyBlocks: number;
 }
-export interface ListsSplitSuccessResult {
+export interface ListsSplitSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     numId: number;
     restartedAt: number | null;
 }
-export interface ListsDetachSuccessResult {
+export interface ListsDetachSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     paragraph: {
@@ -415,7 +415,7 @@ export interface ListsDetachSuccessResult {
         nodeId: string;
     };
 }
-export interface ListsConvertToTextSuccessResult {
+export interface ListsConvertToTextSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     paragraph: {
@@ -447,7 +447,7 @@ export type ListsMergeResult = ListsMergeSuccessResult | ListsFailureResult;
 export type ListsSplitResult = ListsSplitSuccessResult | ListsFailureResult;
 export type ListsDetachResult = ListsDetachSuccessResult | ListsFailureResult;
 export type ListsConvertToTextResult = ListsConvertToTextSuccessResult | ListsFailureResult;
-export interface ListsDeleteSuccessResult {
+export interface ListsDeleteSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     /** Number of list items removed. */

package/dist/document-api/src/receipt-bridge.d.ts

@@ -8,6 +8,9 @@ export interface MutationReceiptBridgeContext {
 }
 interface CanonicalSuccessMetadata {
     appliedChangeMode?: ReceiptSuccess['appliedChangeMode'];
+    changed?: ReceiptSuccess['changed'];
+    trackedChangeRefs?: ReceiptSuccess['trackedChangeRefs'];
+    trackedChangeCount?: ReceiptSuccess['trackedChangeCount'];
     id?: ReceiptSuccess['id'];
     inserted?: ReceiptSuccess['inserted'];
     updated?: ReceiptSuccess['updated'];

package/dist/document-api/src/types/blocks.types.d.ts

@@ -144,7 +144,7 @@ export interface BlocksSplitInput {
     /** Include deleted tracked text in the offset ruler. Defaults to `visible`. */
     coordinateSpace?: 'visible' | 'tracked';
 }
-export interface BlocksSplitSuccessResult {
+export interface BlocksSplitSuccessResult extends Omit<ReceiptSuccess, 'inserted'> {
     success: true;
     appliedChangeMode?: ReceiptSuccess['appliedChangeMode'];
     /** Address of the new paragraph created by the split (the tail). */
@@ -173,7 +173,7 @@ export interface BlocksMergeInput {
     /** Paragraph immediately after `first` in the same story. */
     second: BlockNodeAddress;
 }
-export interface BlocksMergeSuccessResult {
+export interface BlocksMergeSuccessResult extends Omit<ReceiptSuccess, 'removed'> {
     success: true;
     appliedChangeMode?: ReceiptSuccess['appliedChangeMode'];
     /** Address of the paragraph that was removed (the second paragraph). */

package/dist/document-api/src/types/mutation-plan.types.d.ts

@@ -5,7 +5,7 @@ import { InsertStylePolicy, StylePolicy } from './style-policy.types.js';
 import { InlineRunPatch } from '../format/inline-run-patch.js';
 import { SDFragment } from './fragment.js';
 import { Placement, NestingPolicy } from './placement.js';
-import { AffectedRef } from './receipt.js';
+import { AffectedRef, ReceiptSuccess } from './receipt.js';
 import { ChangeMode } from '../write/write.js';
 import { StoryLocator } from './story.types.js';
 export type SelectWhere = {
@@ -241,7 +241,7 @@ export type StepOutcome = {
     trackedChangeIds?: string[];
     data: StepOutcomeData;
 };
-export type PlanReceipt = {
+export type PlanReceipt = ReceiptSuccess & {
     success: true;
     /** Effective mode when every committed step used the same mode. */
     appliedChangeMode?: ChangeMode;

package/dist/document-api/src/types/receipt.d.ts

@@ -110,6 +110,12 @@ export interface ReceiptEffects {
 }
 export type ReceiptSuccess = {
     success: true;
+    /** Whether a successful request changed the document; false represents a no-op commit. */
+    changed?: boolean;
+    /** Tracked changes authored by this mutation. */
+    trackedChangeRefs?: ReceiptInsert[];
+    /** Number of tracked changes authored by this mutation. */
+    trackedChangeCount?: number;
     /**
      * Mode in which this call's document content was committed. An edit folded
      * into the author's existing insertion is tracked; auxiliary style and
@@ -202,6 +208,12 @@ export type TextMutationResolution = {
 };
 export type TextMutationReceipt = (ReceiptSuccess & {
     resolution: TextMutationResolution;
+    /** Per-edit tracked-change results for atomic multi-edit mutations. */
+    trackedChangeOutcomes?: {
+        editIndex: number;
+        trackedChangeCount: number;
+        trackedChangeRefs: ReceiptInsert[];
+    }[];
 }) | (ReceiptFailureResult & {
     resolution: TextMutationResolution;
 });

package/dist/document-api/src/types/sd-contract.d.ts

@@ -32,6 +32,9 @@ export interface SDMutationReceipt {
         before: string;
         after: string;
     };
+    changed?: ReceiptSuccess['changed'];
+    trackedChangeRefs?: ReceiptSuccess['trackedChangeRefs'];
+    trackedChangeCount?: ReceiptSuccess['trackedChangeCount'];
     id?: ReceiptSuccess['id'];
     inserted?: ReceiptSuccess['inserted'];
     updated?: ReceiptSuccess['updated'];

package/dist/document-api/src/types/track-changes.types.d.ts

@@ -351,9 +351,17 @@ export interface TrackChangeStructuralDescriptor {
 export type TrackChangeTarget = {
     kind: 'text';
     address: TrackedChangeAddress;
+    /** Resolved text geometry when available. */
+    segments?: TextTarget['segments'];
+    /** Story containing the resolved geometry. */
+    story?: TextTarget['story'];
 } | {
     kind: 'replacement';
     address: TrackedChangeAddress;
+    /** Resolved text geometry when available. */
+    segments?: TextTarget['segments'];
+    /** Story containing the resolved geometry. */
+    story?: TextTarget['story'];
 } | {
     kind: 'formatting';
     address: TrackedChangeAddress;

package/dist/superdoc.cjs

@@ -304,7 +304,7 @@ var awarenessStatesToArray = (context, states) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.25.0-next.2";
+		return "2.25.0-next.3";
 	} catch {
 		return "unknown";
 	}
@@ -46649,7 +46649,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.25.0-next.2";
+		this.version = "2.25.0-next.3";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -302,7 +302,7 @@ var awarenessStatesToArray = (context, states) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.25.0-next.2";
+		return "2.25.0-next.3";
 	} catch {
 		return "unknown";
 	}
@@ -46578,7 +46578,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.25.0-next.2";
+		this.version = "2.25.0-next.3";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];