superdoc 2.27.0-next.3 → 2.27.0-next.5

package/dist/chunks/{create-super-doc-ui-DK14sCrT.cjs → create-super-doc-ui-CqpZP17K.cjs}

@@ -1078,6 +1078,15 @@ var decodeLayoutStoryDataset = (raw) => {
 `${DOM_CLASS_NAMES.BLOCK_SDT}${DATA_ATTRS.SDT_ID}`;
 `${DATA_ATTRS.DRAGGABLE}`;
 //#endregion
+//#region src/helpers/tracked-change-comment-lane.ts
+var TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX = "tc-comment:";
+function isSyntheticTrackedChangeCommentLaneItem(item) {
+	if (!item || typeof item !== "object") return false;
+	const { id, commentId } = item;
+	const itemId = id ?? commentId;
+	return typeof itemId === "string" && itemId.startsWith(TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX);
+}
+//#endregion
 //#region src/public/ui/viewport-batch.ts
 /** No rendering or scrolling: read only geometry already acknowledged by the host. */
 async function readViewportBatch(input, read, generation, disposed) {
@@ -2635,12 +2644,6 @@ function getV2TrackedChangeMutationImpact(event) {
 }
 /**
 * Comment ids retired by a committed v2 mutation.
-*
-* AIDEV-NOTE: History commits put invalidated comment ids on `result`; cut and
-* other command receipts use `receipt`. Same origin split as
-* getV2TrackedChangeMutationImpact. Reading the wrong field, or treating a
-* tracked-change entity as a comment, leaves a sidebar card after cut or
-* undo/redo.
 */
 function collectV2InvalidatedCommentIds(event) {
 	const removedIds = /* @__PURE__ */ new Set();
@@ -7607,9 +7610,26 @@ function createSuperDocUI(options) {
 		recompute();
 		return selection;
 	};
+	const realComments = (items) => items.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item));
+	let lastWindowComments = null;
+	const realCommentsOfWindow = (window) => {
+		const items = window?.commentItems;
+		if (!Array.isArray(items)) return null;
+		const last = lastWindowComments;
+		if (last?.source === items && shallowEqual(last.rows, items)) return last.real;
+		lastWindowComments = {
+			source: items,
+			rows: [...items],
+			real: realComments(items)
+		};
+		return lastWindowComments.real;
+	};
 	const readCommentsDirectory = () => {
 		const listComments = hostMethod(getDoc()?.comments, "list");
-		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => {
+			const items = isPlainObject(raw) ? raw.items : void 0;
+			return Array.isArray(items) ? realComments(items) : [];
+		});
 	};
 	const readTrackChangesDirectory = (key = "trackChanges") => {
 		const token = contentToken();
@@ -7642,7 +7662,7 @@ function createSuperDocUI(options) {
 		const reviewWindow = getV2ReviewWindowSnapshot();
 		const hasWindowFeed = hasV2ReviewWindowFeed();
 		const catalog = !hasWindowFeed ? readCommentsDirectory() : null;
-		const windowItems = hasWindowFeed && Array.isArray(reviewWindow?.commentItems) ? reviewWindow.commentItems : null;
+		const windowItems = hasWindowFeed ? realCommentsOfWindow(reviewWindow) : null;
 		const value = hasWindowFeed ? windowItems : catalog.value;
 		const listStatus = hasWindowFeed ? reviewWindowSliceStatus(reviewWindow) : catalog.status;
 		const items = value ?? [];
@@ -15124,6 +15144,12 @@ Object.defineProperty(exports, "isPlainObject", {
 		return isPlainObject;
 	}
 });
+Object.defineProperty(exports, "isSyntheticTrackedChangeCommentLaneItem", {
+	enumerable: true,
+	get: function() {
+		return isSyntheticTrackedChangeCommentLaneItem;
+	}
+});
 Object.defineProperty(exports, "isWorkflowRecordingEnabled", {
 	enumerable: true,
 	get: function() {

package/dist/chunks/{create-super-doc-ui-BCQ5RHxy.es.js → create-super-doc-ui-mIZuVMA6.es.js}

@@ -1078,6 +1078,15 @@ var decodeLayoutStoryDataset = (raw) => {
 `${DOM_CLASS_NAMES.BLOCK_SDT}${DATA_ATTRS.SDT_ID}`;
 `${DATA_ATTRS.DRAGGABLE}`;
 //#endregion
+//#region src/helpers/tracked-change-comment-lane.ts
+var TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX = "tc-comment:";
+function isSyntheticTrackedChangeCommentLaneItem(item) {
+	if (!item || typeof item !== "object") return false;
+	const { id, commentId } = item;
+	const itemId = id ?? commentId;
+	return typeof itemId === "string" && itemId.startsWith(TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX);
+}
+//#endregion
 //#region src/public/ui/viewport-batch.ts
 /** No rendering or scrolling: read only geometry already acknowledged by the host. */
 async function readViewportBatch(input, read, generation, disposed) {
@@ -2634,12 +2643,6 @@ function getV2TrackedChangeMutationImpact(event) {
 }
 /**
 * Comment ids retired by a committed v2 mutation.
-*
-* AIDEV-NOTE: History commits put invalidated comment ids on `result`; cut and
-* other command receipts use `receipt`. Same origin split as
-* getV2TrackedChangeMutationImpact. Reading the wrong field, or treating a
-* tracked-change entity as a comment, leaves a sidebar card after cut or
-* undo/redo.
 */
 function collectV2InvalidatedCommentIds(event) {
 	const removedIds = /* @__PURE__ */ new Set();
@@ -7606,9 +7609,26 @@ function createSuperDocUI(options) {
 		recompute();
 		return selection;
 	};
+	const realComments = (items) => items.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item));
+	let lastWindowComments = null;
+	const realCommentsOfWindow = (window) => {
+		const items = window?.commentItems;
+		if (!Array.isArray(items)) return null;
+		const last = lastWindowComments;
+		if (last?.source === items && shallowEqual(last.rows, items)) return last.real;
+		lastWindowComments = {
+			source: items,
+			rows: [...items],
+			real: realComments(items)
+		};
+		return lastWindowComments.real;
+	};
 	const readCommentsDirectory = () => {
 		const listComments = hostMethod(getDoc()?.comments, "list");
-		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => {
+			const items = isPlainObject(raw) ? raw.items : void 0;
+			return Array.isArray(items) ? realComments(items) : [];
+		});
 	};
 	const readTrackChangesDirectory = (key = "trackChanges") => {
 		const token = contentToken();
@@ -7641,7 +7661,7 @@ function createSuperDocUI(options) {
 		const reviewWindow = getV2ReviewWindowSnapshot();
 		const hasWindowFeed = hasV2ReviewWindowFeed();
 		const catalog = !hasWindowFeed ? readCommentsDirectory() : null;
-		const windowItems = hasWindowFeed && Array.isArray(reviewWindow?.commentItems) ? reviewWindow.commentItems : null;
+		const windowItems = hasWindowFeed ? realCommentsOfWindow(reviewWindow) : null;
 		const value = hasWindowFeed ? windowItems : catalog.value;
 		const listStatus = hasWindowFeed ? reviewWindowSliceStatus(reviewWindow) : catalog.status;
 		const items = value ?? [];
@@ -15051,4 +15071,4 @@ function commandIsActive(descriptor, selection) {
 	return descriptor.activeMark ? selection.activeMarks.includes(descriptor.activeMark) : false;
 }
 //#endregion
-export { isWorkflowRecordingEnabled as _, registerFirstPartyCommandMutation as a, getV2TrackedChangeMutationImpact as c, resolveImageSrc as d, shallowEqual as f, getWorkflowRecording as g, createInteractionHistory as h, readFirstPartyPageNumbers as i, isPlainObject as l, closeInteractionHistory as m, executeFirstPartyCommandAsync as n, BUILT_IN_COMMAND_IDS as o, DOM_CLASS_NAMES as p, executeFirstPartyShortcutAsync as r, applyV2CommentInvalidationFromMutation as s, createSuperDocUI as t, createImageFilePicker as u, recordInteraction as v };
+export { getWorkflowRecording as _, registerFirstPartyCommandMutation as a, getV2TrackedChangeMutationImpact as c, resolveImageSrc as d, shallowEqual as f, createInteractionHistory as g, closeInteractionHistory as h, readFirstPartyPageNumbers as i, isPlainObject as l, DOM_CLASS_NAMES as m, executeFirstPartyCommandAsync as n, BUILT_IN_COMMAND_IDS as o, isSyntheticTrackedChangeCommentLaneItem as p, executeFirstPartyShortcutAsync as r, applyV2CommentInvalidationFromMutation as s, createSuperDocUI as t, createImageFilePicker as u, isWorkflowRecordingEnabled as v, recordInteraction as y };

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.27.0-next.3",
+	superdocVersion: "2.27.0-next.5",
 	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.27.0-next.3",
+	superdocVersion: "2.27.0-next.5",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

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

@@ -43,12 +43,6 @@ export interface SDHistoryCollaborationMeta {
  * Result of a history.undo or history.redo action.
  * Mirrors PlanReceipt's revision shape for consistency.
  *
- * AIDEV-NOTE: this shape carries optional ref-effect
- * fields. v1 callers leave them undefined; v2 (`V2HistoryAdapter`) populates
- * them from the stored semantic delta of the undone/redone transaction so
- * callers' held refs stay accurate across history actions. Never make any
- * of the new fields required — v1 adapters MUST keep compiling unchanged.
- *
  * The shape also carries three optional collaboration fields:
  * `status`, `diagnosticCode`, and `collaboration`. v1 leaves them
  * undefined; collaborative v2 sessions populate them so callers can react

package/dist/document-api/src/index.d.ts

@@ -64,7 +64,7 @@ import { CaptionsApi, CaptionsAdapter } from './captions/captions.js';
 import { FieldsApi, FieldsAdapter } from './fields/fields.js';
 import { CitationsApi, CitationsAdapter } from './citations/citations.js';
 import { AuthoritiesApi, AuthoritiesAdapter } from './authorities/authorities.js';
-export type { TemporaryMutationInput, TemporaryMutationHandleInput, TemporaryMutationCommitInput, TemporaryMutationReplaceInput, TemporaryMutationReceipt, TemporaryMutationMetadata, TemporaryMutationOperation, } from './types/temporary-mutation.js';
+export type { TemporaryMutationInput, TemporaryMutationHandleInput, TemporaryMutationCommitInput, TemporaryMutationReplaceInput, TemporaryMutationReceipt, TemporaryMutationMetadata, TemporaryMutationOperation, TemporaryOperationResultTarget, } from './types/temporary-mutation.js';
 export * from './types/index.js';
 export * from './contract/index.js';
 export * from './capabilities/capabilities.js';

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

@@ -1,4 +1,4 @@
-import { BlockNavigationAddress, EntityAddress, SelectionTarget, TextAddress, TrackedChangeAddress } from './address.js';
+import { BlockNavigationAddress, EntityAddress, SelectionTarget, TextAddress, TextTarget, TrackedChangeAddress } from './address.js';
 import { BlockNodeAddress } from './base.js';
 import { BookmarkAddress } from '../bookmarks/bookmarks.types.js';
 import { StoryLocator } from './story.types.js';
@@ -131,6 +131,7 @@ export interface ReceiptEffects {
     insertedText?: TextMutationEffect[];
     /** Blocks created by the mutation, in document order. */
     insertedBlocks?: BlockMutationEffect[];
+    resultText?: TextTarget;
 }
 export type ReceiptSuccess = {
     /** Caller correlation for this commit. Never replayed as the original edit on Undo/Redo. */

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

@@ -22,12 +22,26 @@ type TemporaryText<Name extends 'insert' | 'replace', Input> = {
     }>;
     options: TrackedTextMutationOptions;
 };
+export interface TemporaryOperationResultTarget {
+    kind: 'operationResult';
+    operationId: string;
+}
+type CommentsCreate = DocumentApiSurface['comments']['create'];
+type TemporaryCommentInput = Omit<Parameters<CommentsCreate>[0], 'target'> & {
+    target?: Parameters<CommentsCreate>[0]['target'] | TemporaryOperationResultTarget;
+};
 /** Operations run in order against the temporary document, as one atomic update. */
-export type TemporaryMutationOperation = TemporaryText<'insert', PlainTextInsertInput> | TemporaryText<'replace', TextReplaceInput> | {
+export type TemporaryMutationOperation = {
+    id?: string;
+} & (TemporaryText<'insert', PlainTextInsertInput> | TemporaryText<'replace', TextReplaceInput> | {
     operation: 'replace';
     input: ParagraphTextReplaceInput;
     options?: ReplaceMutationOptions;
-} | TemporaryCall<'delete', DocumentApiSurface['delete']> | TemporaryCall<'blocks.delete', DocumentApiSurface['blocks']['delete']> | TemporaryCall<'trackChanges.decide', DocumentApiSurface['trackChanges']['decide']> | TemporaryCall<'comments.create', DocumentApiSurface['comments']['create']>;
+} | TemporaryCall<'delete', DocumentApiSurface['delete']> | TemporaryCall<'blocks.delete', DocumentApiSurface['blocks']['delete']> | TemporaryCall<'trackChanges.decide', DocumentApiSurface['trackChanges']['decide']> | {
+    operation: 'comments.create';
+    input: TemporaryCommentInput;
+    options?: Parameters<CommentsCreate>[1];
+});
 export interface TemporaryMutationInput {
     /** Host tag echoed on every temporary mutation and its rollback/commit receipt. */
     tag: string;

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DK14sCrT.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CqpZP17K.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 let use_sync_external_store_shim = require("use-sync-external-store/shim");

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BCQ5RHxy.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-mIZuVMA6.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { useSyncExternalStore } from "use-sync-external-store/shim";

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DK14sCrT.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CqpZP17K.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_vue = require("vue");
 //#region src/public/ui/vue.ts

package/dist/public/ui-vue.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BCQ5RHxy.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-mIZuVMA6.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DK14sCrT.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CqpZP17K.cjs");
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {

package/dist/public/ui.es.js

@@ -1,4 +1,4 @@
-import { f as shallowEqual, o as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-BCQ5RHxy.es.js";
+import { f as shallowEqual, o as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-mIZuVMA6.es.js";
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {