@a3s-lab/office 0.7.2 → 0.7.3

package/dist/8928.js

@@ -1,6 +1,7 @@
 import { Extension, Mark, Node as core_Node, ResizableNodeView, generateHTML, getSchema, mergeAttributes } from "@tiptap/core";
 import { Collaboration, isChangeOrigin } from "@tiptap/extension-collaboration";
 import { NodeSelection, Plugin, PluginKey, TextSelection } from "@tiptap/pm/state";
+import { AddMarkStep, Mapping, RemoveMarkStep } from "@tiptap/pm/transform";
 import { defaultDeleteFilter, defaultProtectedNodes, prosemirrorJSONToYXmlFragment, ySyncPluginKey, yXmlFragmentToProsemirrorJSON } from "@tiptap/y-tiptap";
 import extension_color from "@tiptap/extension-color";
 import { Table, TableCell, TableHeader, TableKit, TableRow, TableView, createTable } from "@tiptap/extension-table";
@@ -8,7 +9,6 @@ import extension_text_align from "@tiptap/extension-text-align";
 import font_size from "@tiptap/extension-text-style/font-size";
 import extension_underline from "@tiptap/extension-underline";
 import starter_kit from "@tiptap/starter-kit";
-import { Mapping } from "@tiptap/pm/transform";
 import { DOMParser as model_DOMParser, Fragment, Slice } from "@tiptap/pm/model";
 import jszip from "jszip";
 import { closeHistory, isHistoryTransaction } from "@tiptap/pm/history";
@@ -23,7 +23,7 @@ import { TextStyle } from "@tiptap/extension-text-style";
 import extension_highlight from "@tiptap/extension-highlight";
 import { createOfficeId as createWorkId, parseXml, xmlNamespacePrefix } from "./5184.js";
 import { workOfficeCollaborationJsonEqual, canonicalWorkOfficeCollaborationJson, isWorkOfficeCollaborationRecord, cloneWorkOfficeCollaborationJson } from "./4650.js";
-import { initializeWorkOfficeCollaborationMetadata, assertWorkOfficeCollaborationEditable, OfficeCollaborationError as WorkOfficeCollaborationError, readOfficeCollaborationMetadata as readWorkOfficeCollaborationMetadata, registerWorkOfficeCollaborationInitializer, markWorkOfficeCollaborationInitialized, assertWorkOfficeCollaborationOrigin } from "./9787.js";
+import { assertWorkOfficeCollaborationEditable, markWorkOfficeCollaborationInitialized, assertWorkOfficeCollaborationOrigin, initializeWorkOfficeCollaborationMetadata, assertWorkOfficeCollaborationWritable, OfficeCollaborationError as WorkOfficeCollaborationError, readOfficeCollaborationMetadata as readWorkOfficeCollaborationMetadata, registerWorkOfficeCollaborationInitializer } from "./9787.js";
 import * as __rspack_external_yjs from "yjs";
 const BOOKMARK_REFERENCE_SELECTOR = 'span[data-document-cross-reference][data-reference-target-type="bookmark"]';
 const BLOCK_TEXT_CONTAINER_NAMES = new Set([
@@ -9169,20 +9169,35 @@ function collectDocumentCommentAnchors(document1) {
     return Array.from(anchors.values()).sort((left, right)=>left.from - right.from);
 }
 function documentCommentViews(comments, anchors) {
-    const byId = new Map(comments.map((comment)=>[
-            comment.id,
-            normalizeDocumentComment(comment)
+    const anchorsById = new Map(anchors.map((anchor)=>[
+            anchor.id,
+            anchor
         ]));
-    return anchors.map((anchor)=>({
-            ...byId.get(anchor.id) ?? {
-                id: anchor.id,
-                author: '未知审阅者',
-                date: '',
-                text: '此批注的内容不可用。',
-                resolved: false
-            },
-            ...anchor
-        }));
+    const commentIds = new Set(comments.map((comment)=>comment.id));
+    const views = comments.map((comment)=>{
+        const normalized = normalizeDocumentComment(comment);
+        const anchor = anchorsById.get(comment.id);
+        return anchor ? {
+            ...normalized,
+            ...anchor,
+            detached: false
+        } : {
+            ...normalized,
+            from: null,
+            to: null,
+            anchorText: '',
+            detached: true
+        };
+    });
+    for (const anchor of anchors)if (!commentIds.has(anchor.id)) views.push({
+        author: '未知审阅者',
+        date: '',
+        text: '此批注的内容不可用。',
+        resolved: false,
+        ...anchor,
+        detached: false
+    });
+    return views;
 }
 function retainAnchoredDocumentComments(comments, anchors, retainedIds = new Set()) {
     const ids = new Set(anchors.map((anchor)=>anchor.id));
@@ -9259,19 +9274,25 @@ function documentCommentMark(marks) {
     return marks.find((mark)=>'documentComment' === mark.type.name);
 }
 function normalizeDocumentComment(comment) {
-    return {
+    const normalized = {
         id: comment.id,
         author: comment.author || '未知审阅者',
         date: comment.date || '',
         text: comment.text || '（空批注）',
-        resolved: Boolean(comment.resolved),
-        replies: comment.replies?.map((reply)=>({
-                id: reply.id,
-                author: reply.author || '未知审阅者',
-                date: reply.date || '',
-                text: reply.text || '（空回复）'
-            }))
+        resolved: Boolean(comment.resolved)
     };
+    if (void 0 !== comment.actorId) normalized.actorId = comment.actorId;
+    if (void 0 !== comment.replies) normalized.replies = comment.replies.map((reply)=>{
+        const normalizedReply = {
+            id: reply.id,
+            author: reply.author || '未知审阅者',
+            date: reply.date || '',
+            text: reply.text || '（空回复）'
+        };
+        if (void 0 !== reply.actorId) normalizedReply.actorId = reply.actorId;
+        return normalizedReply;
+    });
+    return normalized;
 }
 function work_document_comments_stringAttribute(value) {
     return 'string' == typeof value ? value : '';
@@ -15767,6 +15788,82 @@ function invalidSharedSidecars(label) {
 function office_document_collaboration_sidecar_utils_isRecord(value) {
     return isWorkOfficeCollaborationRecord(value);
 }
+function assertWorkOfficeDocumentCommentMutationAllowed(session, previous, next) {
+    if ('edit' === session.mode) return;
+    if ('comment' !== session.mode) deniedReviewMutation(session);
+    const actor = requiredReviewActor(session);
+    assertRetainedOrder(previous, next, 'comments');
+    const nextById = new Map(next.map((comment)=>[
+            comment.id,
+            comment
+        ]));
+    const previousIds = new Set(previous.map((comment)=>comment.id));
+    for (const comment of previous){
+        const updated = nextById.get(comment.id);
+        if (!updated) {
+            assertOwnedRecord(comment.actorId, actor, 'own comment');
+            continue;
+        }
+        assertExistingCommentMutation(actor, comment, updated);
+    }
+    for (const comment of next)if (!previousIds.has(comment.id)) assertNewComment(actor, comment);
+}
+function assertExistingCommentMutation(actor, previous, next) {
+    if (previous.id !== next.id || previous.actorId !== next.actorId || previous.author !== next.author || previous.date !== next.date || previous.text !== next.text) deniedImmutableRecord('comment');
+    assertReplyMutations(actor, previous.id, previous.replies ?? [], next.replies ?? []);
+}
+function assertReplyMutations(actor, commentId, previous, next) {
+    assertRetainedOrder(previous, next, `replies in comment '${commentId}'`);
+    const nextById = new Map(next.map((reply)=>[
+            reply.id,
+            reply
+        ]));
+    const previousIds = new Set(previous.map((reply)=>reply.id));
+    for (const reply of previous){
+        const updated = nextById.get(reply.id);
+        if (!updated) {
+            assertOwnedRecord(reply.actorId, actor, 'own comment reply');
+            continue;
+        }
+        if (!jsonEqual(reply, updated)) deniedImmutableRecord('comment reply');
+    }
+    for (const reply of next)if (!previousIds.has(reply.id)) assertActorRecord(actor, reply, 'reply');
+}
+function assertNewComment(actor, comment) {
+    assertActorRecord(actor, comment, 'comment');
+    for (const reply of comment.replies ?? [])assertActorRecord(actor, reply, 'reply');
+}
+function assertActorRecord(actor, record, label) {
+    if (record.actorId === actor.id && record.author === actor.name) return;
+    throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', `A Document ${label} created in comment mode must use collaboration actor '${actor.id}' and its current display name.`);
+}
+function assertOwnedRecord(actorId, actor, label) {
+    if (actorId === actor.id) return;
+    throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', `Comment mode can delete only the collaboration actor's ${label}.`);
+}
+function assertRetainedOrder(previous, next, label) {
+    const previousIds = new Set(previous.map((record)=>record.id));
+    const nextIds = new Set(next.map((record)=>record.id));
+    const retainedBefore = previous.filter((record)=>nextIds.has(record.id)).map((record)=>record.id);
+    const retainedAfter = next.filter((record)=>previousIds.has(record.id)).map((record)=>record.id);
+    let encounteredNewRecord = false;
+    let existingAfterNewRecord = false;
+    for (const record of next)if (previousIds.has(record.id)) {
+        if (encounteredNewRecord) existingAfterNewRecord = true;
+    } else encounteredNewRecord = true;
+    if (jsonEqual(retainedBefore, retainedAfter) && !existingAfterNewRecord) return;
+    throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', `Comment mode must preserve existing ${label} order and append new review records.`);
+}
+function requiredReviewActor(session) {
+    if (session.actor) return session.actor;
+    throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', 'Comment mode requires a collaboration actor before it can write review records.');
+}
+function deniedImmutableRecord(label) {
+    throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', `Comment mode cannot rewrite an existing ${label}; it may append replies or change resolution state.`);
+}
+function deniedReviewMutation(session) {
+    throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', `The '${session.mode}' collaboration mode cannot modify Document review records.`);
+}
 function validatedWorkOfficeDocumentBibliography(value) {
     if (!office_document_collaboration_sidecar_utils_isRecord(value) || !isCitationStyle(value.style)) invalidInputSidecars('a supported bibliography style');
     if (!Array.isArray(value.sources)) invalidInputSidecars('an array of bibliography sources');
@@ -15995,6 +16092,7 @@ function validatedComment(value) {
         text: requiredString(value.text, 'comment text'),
         resolved: requiredBoolean(value.resolved, 'comment resolution')
     };
+    if (void 0 !== value.actorId) comment.actorId = requiredIdentifier(value.actorId, 'comment actor');
     if (void 0 !== value.replies) {
         if (!Array.isArray(value.replies)) invalidInputSidecars('an array of comment replies');
         const ids = new Set();
@@ -16009,17 +16107,20 @@ function validatedComment(value) {
 }
 function validatedReply(value) {
     if (!office_document_collaboration_sidecar_utils_isRecord(value)) invalidInputSidecars('valid comment reply records');
-    return {
+    const reply = {
         id: requiredIdentifier(value.id, 'comment reply'),
         author: requiredString(value.author, 'comment reply author'),
         date: requiredString(value.date, 'comment reply date'),
         text: requiredString(value.text, 'comment reply text')
     };
+    if (void 0 !== value.actorId) reply.actorId = requiredIdentifier(value.actorId, 'comment reply actor');
+    return reply;
 }
 function createCommentRecord(records, comment) {
     const record = new __rspack_external_yjs.Map();
     records.set(comment.id, record);
     record.set('id', comment.id);
+    if (void 0 !== comment.actorId) record.set('actorId', comment.actorId);
     record.set('author', comment.author);
     record.set('date', comment.date);
     record.set('text', comment.text);
@@ -16039,6 +16140,7 @@ function createReplyRecord(records, reply) {
     const record = new __rspack_external_yjs.Map();
     records.set(reply.id, record);
     record.set('id', reply.id);
+    if (void 0 !== reply.actorId) record.set('actorId', reply.actorId);
     record.set('author', reply.author);
     record.set('date', reply.date);
     record.set('text', reply.text);
@@ -16056,20 +16158,26 @@ function readCommentRecord(record, expectedId) {
         text: requiredSharedString(record.get('text'), 'comment text'),
         resolved: requiredSharedBoolean(record.get('resolved'), 'comment resolution')
     };
+    const actorId = optionalSharedIdentifier(record.get('actorId'), 'comment actor');
+    if (void 0 !== actorId) comment.actorId = actorId;
     if (orderedReplies.length > 0) comment.replies = orderedReplies;
     return comment;
 }
 function readReplyRecord(record, expectedId) {
     const id = requiredSharedIdentifier(record.get('id'), 'comment reply');
     if (id !== expectedId) invalidSharedSidecars('comment reply identity');
-    return {
+    const reply = {
         id,
         author: requiredSharedString(record.get('author'), 'comment reply author'),
         date: requiredSharedString(record.get('date'), 'comment reply date'),
         text: requiredSharedString(record.get('text'), 'comment reply text')
     };
+    const actorId = optionalSharedIdentifier(record.get('actorId'), 'comment reply actor');
+    if (void 0 !== actorId) reply.actorId = actorId;
+    return reply;
 }
 function patchCommentRecord(record, previous, next) {
+    patchOptionalScalar(record, 'actorId', previous.actorId, next.actorId);
     patchRequiredScalar(record, 'author', previous.author, next.author);
     patchRequiredScalar(record, 'date', previous.date, next.date);
     patchRequiredScalar(record, 'text', previous.text, next.text);
@@ -16098,11 +16206,15 @@ function patchReplies(records, order, previous, next) {
         }
         if (jsonEqual(before, reply)) continue;
         const record = requiredSharedMap(records, reply.id, 'comment reply');
+        patchOptionalScalar(record, 'actorId', before.actorId, reply.actorId);
         patchRequiredScalar(record, 'author', before.author, reply.author);
         patchRequiredScalar(record, 'date', before.date, reply.date);
         patchRequiredScalar(record, 'text', before.text, reply.text);
     }
 }
+function optionalSharedIdentifier(value, label) {
+    return void 0 === value ? void 0 : requiredSharedIdentifier(value, label);
+}
 function appendWorkOfficeDocumentRecordClaims(claims, previous, next) {
     const previousComments = new Map((previous.comments ?? []).map((comment)=>[
             comment.id,
@@ -16246,6 +16358,7 @@ function updateWorkOfficeDocumentSidecars(session, previous, next, origin) {
     const before = validatedWorkOfficeDocumentSidecars(previous);
     const after = validatedWorkOfficeDocumentSidecars(next);
     if (jsonEqual(before, after)) return false;
+    assertDocumentSidecarMutationAllowed(session, before, after);
     const roots = documentSidecarRoots(session);
     const shared = readWorkOfficeDocumentSidecars(session);
     assertWorkOfficeDocumentCommentConflicts(before.comments ?? [], after.comments ?? [], shared.comments ?? []);
@@ -16262,7 +16375,7 @@ function updateWorkOfficeDocumentSidecars(session, previous, next, origin) {
             patchPresence(roots.options, 'bibliographyPresent', before.bibliography, after.bibliography, false);
             patchWorkOfficeDocumentBibliography(roots.bibliography, roots.bibliographySources, roots.bibliographySourceOrder, before.bibliography, after.bibliography);
         }
-    }, origin);
+    }, origin, 'comment' === session.mode ? 'document-comment' : 'content');
     return true;
 }
 function workOfficeDocumentSidecarUndoScope(session) {
@@ -16296,6 +16409,12 @@ function validatedWorkOfficeDocumentSidecars(content) {
     if (void 0 !== content.bibliography) result.bibliography = validatedWorkOfficeDocumentBibliography(content.bibliography);
     return result;
 }
+function assertDocumentSidecarMutationAllowed(session, previous, next) {
+    if ('edit' === session.mode) return;
+    if ('comment' !== session.mode) return void assertWorkOfficeCollaborationEditable(session);
+    if (!jsonEqual(previous.pageColor, next.pageColor) || !jsonEqual(previous.trackChanges, next.trackChanges) || !jsonEqual(previous.bibliography, next.bibliography)) throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', 'The comment collaboration mode can modify only Document review records.');
+    assertWorkOfficeDocumentCommentMutationAllowed(session, previous.comments ?? [], next.comments ?? []);
+}
 function documentSidecarRoots(session) {
     return {
         options: session.document.getMap(session.rootName(DOCUMENT_OPTIONS_ROOT)),
@@ -16318,6 +16437,7 @@ function patchPresence(target, key, previous, next, absentValue) {
     else target.delete(key);
 }
 const DOCUMENT_CONTENT_ROOT = 'document.content';
+const MAX_DOCUMENT_COMMENT_HISTORY = 100;
 const mountedDocumentBindings = new WeakMap();
 function initializeWorkOfficeDocumentCollaboration(session, content) {
     assertDocumentSession(session);
@@ -16381,6 +16501,9 @@ class WorkOfficeDocumentCollaborationBindingImpl {
     #listeners = new Set();
     #errorListeners = new Set();
     #historyListeners = new Set();
+    #commentUndoStack = [];
+    #commentRedoStack = [];
+    #applyingCommentHistory = false;
     #destroyed = false;
     #destroyRequested = false;
     #observersAttached = false;
@@ -16418,10 +16541,13 @@ class WorkOfficeDocumentCollaborationBindingImpl {
         ]));
         const existing = mountedDocumentBindings.get(session.document);
         if (existing) throw new WorkOfficeCollaborationError('office.collaboration.content_invalid', 'Only one Document collaboration binding may use a local Y.Doc at a time. Give each editor client its own synchronized Y.Doc.');
-        this.#undoManager = new __rspack_external_yjs.UndoManager([
+        const undoScope = 'comment' === session.mode ? [
+            this.fragment
+        ] : [
             this.fragment,
             ...workOfficeDocumentSidecarUndoScope(session)
-        ], {
+        ];
+        this.#undoManager = new __rspack_external_yjs.UndoManager(undoScope, {
             captureTimeout: options.captureTimeoutMs ?? 500,
             captureTransaction: (transaction)=>false !== transaction.meta.get('addToHistory'),
             deleteFilter: (item)=>defaultDeleteFilter(item, defaultProtectedNodes),
@@ -16433,7 +16559,7 @@ class WorkOfficeDocumentCollaborationBindingImpl {
         const restore = restorable.restore?.bind(this.#undoManager);
         if (restore) restorable.restore = ()=>{
             restore();
-            this.#undoManager.addToScope([
+            this.#undoManager.addToScope('comment' === this.#session.mode ? this.fragment : [
                 this.fragment,
                 ...workOfficeDocumentSidecarUndoScope(this.#session)
             ]);
@@ -16466,23 +16592,41 @@ class WorkOfficeDocumentCollaborationBindingImpl {
     }
     updateSidecars(previous, next) {
         this.ensureActive();
-        return updateWorkOfficeDocumentSidecars(this.#session, previous, next, this.origin);
+        const historyEntry = 'comment' !== this.#session.mode || this.#applyingCommentHistory ? null : createDocumentCommentHistoryEntry(previous, next);
+        if (historyEntry?.commentMembershipChanged) this.#undoManager.stopCapturing();
+        const changed = updateWorkOfficeDocumentSidecars(this.#session, previous, next, this.origin);
+        if (changed && historyEntry) {
+            appendBoundedCommentHistory(this.#commentUndoStack, historyEntry);
+            this.#commentRedoStack.length = 0;
+            this.#onHistoryChange();
+        }
+        return changed;
     }
     canUndo() {
         this.ensureActive();
+        if ('comment' === this.#session.mode) return this.#commentUndoStack.length > 0 || this.#undoManager.canUndo();
         return this.#undoManager.canUndo();
     }
     canRedo() {
         this.ensureActive();
+        if ('comment' === this.#session.mode) return this.#commentRedoStack.length > 0 || this.#undoManager.canRedo();
         return this.#undoManager.canRedo();
     }
     undo() {
         this.ensureActive();
+        if ('comment' === this.#session.mode) {
+            assertWorkOfficeCollaborationWritable(this.#session, 'document-comment');
+            return this.applyCommentHistory('undo');
+        }
         assertWorkOfficeCollaborationEditable(this.#session);
         return null !== this.#undoManager.undo();
     }
     redo() {
         this.ensureActive();
+        if ('comment' === this.#session.mode) {
+            assertWorkOfficeCollaborationWritable(this.#session, 'document-comment');
+            return this.applyCommentHistory('redo');
+        }
         assertWorkOfficeCollaborationEditable(this.#session);
         return null !== this.#undoManager.redo();
     }
@@ -16559,6 +16703,30 @@ class WorkOfficeDocumentCollaborationBindingImpl {
     #onHistoryChange = ()=>{
         for (const listener of this.#historyListeners)listener();
     };
+    applyCommentHistory(direction) {
+        const sourceStack = 'undo' === direction ? this.#commentUndoStack : this.#commentRedoStack;
+        const targetStack = 'undo' === direction ? this.#commentRedoStack : this.#commentUndoStack;
+        const entry = sourceStack.pop();
+        if (!entry) return 'undo' === direction ? null !== this.#undoManager.undo() : null !== this.#undoManager.redo();
+        const from = 'undo' === direction ? entry.after : entry.before;
+        const to = 'undo' === direction ? entry.before : entry.after;
+        const current = this.content();
+        const comments = reconcileDocumentCommentHistory(current.comments, from, to);
+        let sidecarsChanged = false;
+        this.#applyingCommentHistory = true;
+        try {
+            if (!jsonEqual(current.comments, comments)) sidecarsChanged = this.updateSidecars(current, {
+                ...current,
+                comments
+            });
+        } finally{
+            this.#applyingCommentHistory = false;
+        }
+        const anchorChanged = entry.commentMembershipChanged ? 'undo' === direction ? null !== this.#undoManager.undo() : null !== this.#undoManager.redo() : false;
+        appendBoundedCommentHistory(targetStack, entry);
+        this.#onHistoryChange();
+        return sidecarsChanged || anchorChanged;
+    }
     finishDestroy(destroyUndoManager) {
         if (this.#destroyed) return;
         this.#destroyed = true;
@@ -16572,6 +16740,8 @@ class WorkOfficeDocumentCollaborationBindingImpl {
         this.#listeners.clear();
         this.#errorListeners.clear();
         this.#historyListeners.clear();
+        this.#commentUndoStack.length = 0;
+        this.#commentRedoStack.length = 0;
     }
     detachObservers() {
         if (!this.#observersAttached) return;
@@ -16587,6 +16757,104 @@ class WorkOfficeDocumentCollaborationBindingImpl {
         throw new WorkOfficeCollaborationError('office.collaboration.binding_destroyed', 'The Document collaboration binding has been destroyed.');
     }
 }
+function createDocumentCommentHistoryEntry(previous, next) {
+    if (jsonEqual(previous.comments, next.comments)) return null;
+    const before = cloneDocumentComments(previous.comments);
+    const after = cloneDocumentComments(next.comments);
+    return {
+        before,
+        after,
+        commentMembershipChanged: !sameDocumentCommentMembership(before, after)
+    };
+}
+function appendBoundedCommentHistory(stack, entry) {
+    stack.push(entry);
+    if (stack.length > MAX_DOCUMENT_COMMENT_HISTORY) stack.shift();
+}
+function sameDocumentCommentMembership(left, right) {
+    return jsonEqual((left ?? []).map(({ id })=>id), (right ?? []).map(({ id })=>id));
+}
+function reconcileDocumentCommentHistory(current, from, to) {
+    const fromById = new Map((from ?? []).map((comment)=>[
+            comment.id,
+            comment
+        ]));
+    const toById = new Map((to ?? []).map((comment)=>[
+            comment.id,
+            comment
+        ]));
+    const result = cloneDocumentComments(current) ?? [];
+    const resultById = ()=>new Map(result.map((comment)=>[
+                comment.id,
+                comment
+            ]));
+    const orderedIds = [
+        ...(from ?? []).map(({ id })=>id),
+        ...(to ?? []).map(({ id })=>id)
+    ].filter((id, index, ids)=>ids.indexOf(id) === index);
+    for (const id of orderedIds){
+        const source = fromById.get(id);
+        const target = toById.get(id);
+        const currentById = resultById();
+        const existing = currentById.get(id);
+        if (!source && target) {
+            if (!existing) result.push(cloneDocumentComment(target));
+            continue;
+        }
+        if (source && !target) {
+            if (existing && jsonEqual(existing, source)) result.splice(result.findIndex((comment)=>comment.id === id), 1);
+            continue;
+        }
+        if (!source || !target || !existing) continue;
+        const next = reconcileExistingDocumentComment(existing, source, target);
+        const index = result.findIndex((comment)=>comment.id === id);
+        if (index >= 0) result[index] = next;
+    }
+    if (result.length > 0) return result;
+    return void 0 === to ? void 0 : [];
+}
+function reconcileExistingDocumentComment(current, from, to) {
+    const next = cloneDocumentComment(current);
+    if (from.resolved !== to.resolved && current.resolved === from.resolved) next.resolved = to.resolved;
+    const fromReplies = new Map((from.replies ?? []).map((reply)=>[
+            reply.id,
+            reply
+        ]));
+    const toReplies = new Map((to.replies ?? []).map((reply)=>[
+            reply.id,
+            reply
+        ]));
+    const replies = (next.replies ?? []).map((reply)=>({
+            ...reply
+        }));
+    const replyIds = [
+        ...(from.replies ?? []).map(({ id })=>id),
+        ...(to.replies ?? []).map(({ id })=>id)
+    ].filter((id, index, ids)=>ids.indexOf(id) === index);
+    for (const id of replyIds){
+        const source = fromReplies.get(id);
+        const target = toReplies.get(id);
+        const index = replies.findIndex((reply)=>reply.id === id);
+        if (!source && target && index < 0) replies.push({
+            ...target
+        });
+        else if (source && !target && index >= 0 && jsonEqual(replies[index], source)) replies.splice(index, 1);
+    }
+    if (replies.length > 0 || void 0 !== to.replies) next.replies = replies;
+    else delete next.replies;
+    return next;
+}
+function cloneDocumentComments(comments) {
+    return comments?.map(cloneDocumentComment);
+}
+function cloneDocumentComment(comment) {
+    return {
+        ...comment,
+        replies: comment.replies?.map((reply)=>({
+                ...reply
+            }))
+    };
+}
 function workOfficeDocumentCollaborationFragment(session) {
     assertDocumentSession(session);
     return session.document.getXmlFragment(session.rootName(DOCUMENT_CONTENT_ROOT));
@@ -16676,7 +16944,7 @@ function documentCollaborationPermissionExtension(session) {
             return [
                 new Plugin({
                     filterTransaction (transaction) {
-                        return 'edit' === session.mode || !transaction.docChanged || isChangeOrigin(transaction);
+                        return 'edit' === session.mode || !transaction.docChanged || isChangeOrigin(transaction) || 'comment' === session.mode && transaction.steps.length > 0 && transaction.steps.every((step)=>(step instanceof AddMarkStep || step instanceof RemoveMarkStep) && 'documentComment' === step.mark.type.name);
                     }
                 })
             ];

package/dist/9787.js

@@ -52,9 +52,9 @@ class WorkOfficeCollaborationSessionImpl {
             operationId: void 0 === operationId ? void 0 : normalizedIdentifier(operationId, 'operation ID')
         });
     }
-    transact(operation, origin = this.localOrigin) {
+    transact(operation, origin = this.localOrigin, scope = 'content') {
         this.ensureActive();
-        assertWorkOfficeCollaborationEditable(this);
+        assertWorkOfficeCollaborationWritable(this, scope);
         assertWorkOfficeCollaborationOrigin(origin);
         let result;
         this.document.transact((transaction)=>{
@@ -132,8 +132,17 @@ function registerWorkOfficeCollaborationInitializer(session) {
     ]);
 }
 function assertWorkOfficeCollaborationEditable(session) {
+    assertWorkOfficeCollaborationWritable(session, 'content');
+}
+function assertWorkOfficeCollaborationWritable(session, scope) {
+    const normalizedScope = normalizedMutationScope(scope);
     if ('edit' === session.mode) return;
-    throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', `The '${session.mode}' collaboration mode cannot modify canonical content.`);
+    if ('comment' === session.mode && 'document' === session.kind && 'document-comment' === normalizedScope) return;
+    throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', 'document-comment' === normalizedScope ? `The '${session.mode}' collaboration mode cannot modify Document review records.` : `The '${session.mode}' collaboration mode cannot modify canonical content.`);
+}
+function normalizedMutationScope(value) {
+    if ('content' === value || 'document-comment' === value) return value;
+    throw new WorkOfficeCollaborationError('office.collaboration.mutation_scope_invalid', `The collaboration mutation scope '${String(value)}' is invalid.`);
 }
 function assertSessionMetadata(session) {
     readWorkOfficeCollaborationMetadata(session);
@@ -206,4 +215,4 @@ function normalizedRootSuffix(value) {
 function isWorkArtifactKind(value) {
     return 'document' === value || 'markdown' === value || 'spreadsheet' === value || 'presentation' === value || 'pdf' === value;
 }
-export { WORK_OFFICE_COLLABORATION_NAMESPACE as OFFICE_COLLABORATION_NAMESPACE, WORK_OFFICE_COLLABORATION_PROTOCOL as OFFICE_COLLABORATION_PROTOCOL, WorkOfficeCollaborationError as OfficeCollaborationError, assertWorkOfficeCollaborationEditable, assertWorkOfficeCollaborationOrigin, createWorkOfficeCollaborationSession as createOfficeCollaborationSession, initializeWorkOfficeCollaborationMetadata, markWorkOfficeCollaborationInitialized, readWorkOfficeCollaborationMetadata as readOfficeCollaborationMetadata, registerWorkOfficeCollaborationInitializer };
+export { WORK_OFFICE_COLLABORATION_NAMESPACE as OFFICE_COLLABORATION_NAMESPACE, WORK_OFFICE_COLLABORATION_PROTOCOL as OFFICE_COLLABORATION_PROTOCOL, WorkOfficeCollaborationError as OfficeCollaborationError, assertWorkOfficeCollaborationEditable, assertWorkOfficeCollaborationOrigin, assertWorkOfficeCollaborationWritable, createWorkOfficeCollaborationSession as createOfficeCollaborationSession, initializeWorkOfficeCollaborationMetadata, markWorkOfficeCollaborationInitialized, readWorkOfficeCollaborationMetadata as readOfficeCollaborationMetadata, registerWorkOfficeCollaborationInitializer };

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-export type { WorkOfficeCollaborationActor as OfficeCollaborationActor, WorkOfficeCollaborationActorKind as OfficeCollaborationActorKind, WorkOfficeCollaborationAwareness as OfficeCollaborationAwareness, WorkOfficeCollaborationErrorCode as OfficeCollaborationErrorCode, WorkOfficeCollaborationMetadata as OfficeCollaborationMetadata, WorkOfficeCollaborationMode as OfficeCollaborationMode, WorkOfficeCollaborationOrigin as OfficeCollaborationOrigin, WorkOfficeCollaborationOriginKind as OfficeCollaborationOriginKind, WorkOfficeCollaborationSession as OfficeCollaborationSession, WorkOfficeCollaborationSessionOptions as OfficeCollaborationSessionOptions, } from './internal/collaboration/office-collaboration';
+export type { WorkOfficeCollaborationActor as OfficeCollaborationActor, WorkOfficeCollaborationActorKind as OfficeCollaborationActorKind, WorkOfficeCollaborationAwareness as OfficeCollaborationAwareness, WorkOfficeCollaborationErrorCode as OfficeCollaborationErrorCode, WorkOfficeCollaborationMetadata as OfficeCollaborationMetadata, WorkOfficeCollaborationMode as OfficeCollaborationMode, WorkOfficeCollaborationMutationScope as OfficeCollaborationMutationScope, WorkOfficeCollaborationOrigin as OfficeCollaborationOrigin, WorkOfficeCollaborationOriginKind as OfficeCollaborationOriginKind, WorkOfficeCollaborationSession as OfficeCollaborationSession, WorkOfficeCollaborationSessionOptions as OfficeCollaborationSessionOptions, } from './internal/collaboration/office-collaboration';
 export { createWorkOfficeCollaborationSession as createOfficeCollaborationSession, readWorkOfficeCollaborationMetadata as readOfficeCollaborationMetadata, WORK_OFFICE_COLLABORATION_NAMESPACE as OFFICE_COLLABORATION_NAMESPACE, WORK_OFFICE_COLLABORATION_PROTOCOL as OFFICE_COLLABORATION_PROTOCOL, WORK_OFFICE_COLLABORATION_VERSION as OFFICE_COLLABORATION_VERSION, WorkOfficeCollaborationError as OfficeCollaborationError, } from './internal/collaboration/office-collaboration';
 export type { WorkOfficeCollaborationParticipant as OfficeCollaborationParticipant, WorkOfficeCollaborationPresence as OfficeCollaborationPresence, WorkOfficeCollaborationPresenceActivity as OfficeCollaborationPresenceActivity, WorkOfficeCollaborationPresenceActor as OfficeCollaborationPresenceActor, WorkOfficeCollaborationPresenceLocation as OfficeCollaborationPresenceLocation, WorkOfficeCollaborationPresenceSnapshot as OfficeCollaborationPresenceSnapshot, WorkOfficeCollaborationPresenceState as OfficeCollaborationPresenceState, WorkOfficeCollaborationPresenceUpdate as OfficeCollaborationPresenceUpdate, WorkOfficeDocumentPresenceLocation as OfficeDocumentPresenceLocation, WorkOfficeMarkdownPresenceLocation as OfficeMarkdownPresenceLocation, WorkOfficePdfPresenceLocation as OfficePdfPresenceLocation, WorkOfficePresentationPresenceLocation as OfficePresentationPresenceLocation, WorkOfficeSpreadsheetPresenceCell as OfficeSpreadsheetPresenceCell, WorkOfficeSpreadsheetPresenceLocation as OfficeSpreadsheetPresenceLocation, WorkOfficeSpreadsheetPresenceRange as OfficeSpreadsheetPresenceRange, WorkOfficeTextPresenceLocation as OfficeTextPresenceLocation, } from './internal/collaboration/office-collaboration-presence';
 export { createWorkOfficeCollaborationPresence as createOfficeCollaborationPresence, WORK_OFFICE_COLLABORATION_PRESENCE_FIELD as OFFICE_COLLABORATION_PRESENCE_FIELD, } from './internal/collaboration/office-collaboration-presence';

package/dist/internal/collaboration/office-collaboration.d.ts

@@ -13,6 +13,7 @@ export interface WorkOfficeCollaborationActor {
     kind?: WorkOfficeCollaborationActorKind;
 }
 export type WorkOfficeCollaborationOriginKind = 'bootstrap' | 'editor' | 'agent' | 'import' | 'system';
+export type WorkOfficeCollaborationMutationScope = 'content' | 'document-comment';
 export interface WorkOfficeCollaborationOrigin {
     readonly protocol: typeof WORK_OFFICE_COLLABORATION_PROTOCOL;
     readonly kind: WorkOfficeCollaborationOriginKind;
@@ -68,10 +69,10 @@ export interface WorkOfficeCollaborationSession {
     metadata(): WorkOfficeCollaborationMetadata | null;
     rootName(suffix: string): string;
     createOrigin(kind: WorkOfficeCollaborationOriginKind, operationId?: string): WorkOfficeCollaborationOrigin;
-    transact<T>(operation: (transaction: Y.Transaction) => T, origin?: WorkOfficeCollaborationOrigin): T;
+    transact<T>(operation: (transaction: Y.Transaction) => T, origin?: WorkOfficeCollaborationOrigin, scope?: WorkOfficeCollaborationMutationScope): T;
     destroy(): void;
 }
-export type WorkOfficeCollaborationErrorCode = 'office.collaboration.actor_invalid' | 'office.collaboration.artifact_mismatch' | 'office.collaboration.binding_destroyed' | 'office.collaboration.bootstrap_ambiguous' | 'office.collaboration.bootstrap_invalid' | 'office.collaboration.content_invalid' | 'office.collaboration.identifier_invalid' | 'office.collaboration.kind_invalid' | 'office.collaboration.kind_mismatch' | 'office.collaboration.metadata_invalid' | 'office.collaboration.metadata_missing' | 'office.collaboration.mode_invalid' | 'office.collaboration.namespace_invalid' | 'office.collaboration.not_initialized' | 'office.collaboration.origin_invalid' | 'office.collaboration.permission_denied' | 'office.collaboration.presence_conflict' | 'office.collaboration.presence_invalid' | 'office.collaboration.presence_unavailable' | 'office.collaboration.root_invalid' | 'office.collaboration.session_destroyed' | 'office.collaboration.transport_identity_mismatch' | 'office.collaboration.transport_invalid' | 'office.collaboration.transport_message_invalid' | 'office.collaboration.transport_message_too_large';
+export type WorkOfficeCollaborationErrorCode = 'office.collaboration.actor_invalid' | 'office.collaboration.artifact_mismatch' | 'office.collaboration.binding_destroyed' | 'office.collaboration.bootstrap_ambiguous' | 'office.collaboration.bootstrap_invalid' | 'office.collaboration.content_invalid' | 'office.collaboration.identifier_invalid' | 'office.collaboration.kind_invalid' | 'office.collaboration.kind_mismatch' | 'office.collaboration.metadata_invalid' | 'office.collaboration.metadata_missing' | 'office.collaboration.mode_invalid' | 'office.collaboration.mutation_scope_invalid' | 'office.collaboration.namespace_invalid' | 'office.collaboration.not_initialized' | 'office.collaboration.origin_invalid' | 'office.collaboration.permission_denied' | 'office.collaboration.presence_conflict' | 'office.collaboration.presence_invalid' | 'office.collaboration.presence_unavailable' | 'office.collaboration.root_invalid' | 'office.collaboration.session_destroyed' | 'office.collaboration.transport_identity_mismatch' | 'office.collaboration.transport_invalid' | 'office.collaboration.transport_message_invalid' | 'office.collaboration.transport_message_too_large';
 export declare class WorkOfficeCollaborationError extends Error {
     readonly code: WorkOfficeCollaborationErrorCode;
     constructor(code: WorkOfficeCollaborationErrorCode, message: string);
@@ -82,4 +83,5 @@ export declare function initializeWorkOfficeCollaborationMetadata(session: WorkO
 export declare function markWorkOfficeCollaborationInitialized(session: WorkOfficeCollaborationSession): void;
 export declare function registerWorkOfficeCollaborationInitializer(session: WorkOfficeCollaborationSession): void;
 export declare function assertWorkOfficeCollaborationEditable(session: WorkOfficeCollaborationSession): void;
+export declare function assertWorkOfficeCollaborationWritable(session: WorkOfficeCollaborationSession, scope: WorkOfficeCollaborationMutationScope): void;
 export declare function assertWorkOfficeCollaborationOrigin(origin: WorkOfficeCollaborationOrigin): void;

package/dist/internal/collaboration/office-document-collaboration-comment-permissions.d.ts

@@ -0,0 +1,3 @@
+import type { WorkDocumentComment } from '../features/work/work-types';
+import { type WorkOfficeCollaborationSession } from './office-collaboration';
+export declare function assertWorkOfficeDocumentCommentMutationAllowed(session: WorkOfficeCollaborationSession, previous: readonly WorkDocumentComment[], next: readonly WorkDocumentComment[]): void;

package/dist/internal/features/work/editors/document-comment-composer.d.ts

@@ -5,6 +5,7 @@ export interface DocumentCommentDraft {
     anchorText: string;
 }
 export declare const DocumentCommentComposer: import("react").ForwardRefExoticComponent<{
+    author?: string;
     draft: DocumentCommentDraft;
     top: number;
     onCancel: () => void;

package/dist/internal/features/work/editors/document-comments-panel.d.ts

@@ -2,10 +2,12 @@ import type { Editor } from '@tiptap/core';
 import { type RefObject } from 'react';
 import { type WorkDocumentCommentView } from '../work-document-comments';
 import { type DocumentCommentDraft } from './document-comment-composer';
-export declare function DocumentCommentsPanel({ editor, comments, draft, surfaceRef, onReply, onToggleResolved, onDelete, onCancelDraft, onSubmitDraft, onClose, onDirtyChange, }: {
+export declare function DocumentCommentsPanel({ editor, comments, canDelete, draft, draftAuthor, surfaceRef, onReply, onToggleResolved, onDelete, onCancelDraft, onSubmitDraft, onClose, onDirtyChange, }: {
     editor: Editor;
     comments: WorkDocumentCommentView[];
+    canDelete?: (id: string) => boolean;
     draft: DocumentCommentDraft | null;
+    draftAuthor?: string;
     surfaceRef: RefObject<HTMLDivElement | null>;
     onReply: (id: string, text: string) => void;
     onToggleResolved: (id: string) => void;