@a3s-lab/office 0.7.3 → 0.8.0

package/dist/8928.js

@@ -1,7 +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 { AddMarkStep, Mapping, RemoveMarkStep, ReplaceStep } 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";
@@ -6697,6 +6697,7 @@ const DocumentParagraphIdentity = Extension.create({
     name: 'documentParagraphIdentity',
     addOptions () {
         return {
+            rotateTextId: ()=>true,
             types: [
                 'paragraph',
                 'heading',
@@ -6735,7 +6736,7 @@ const DocumentParagraphIdentity = Extension.create({
     },
     addProseMirrorPlugins () {
         return [
-            createDocumentParagraphIdentityPlugin(this.options.types)
+            createDocumentParagraphIdentityPlugin(this.options.types, this.options.rotateTextId)
         ];
     }
 });
@@ -6776,11 +6777,11 @@ function applyDocumentParagraphIdentityToElement(element, source) {
     element.setAttribute(DOCUMENT_PARAGRAPH_TEXT_ID_ATTRIBUTE, identity.textId);
     return identity;
 }
-function createDocumentParagraphIdentityPlugin(types) {
+function createDocumentParagraphIdentityPlugin(types, rotateTextId) {
     const trackedTypes = new Set(types);
     return new Plugin({
         view (view) {
-            const transaction = normalizeDocumentParagraphIdentities(view.state, trackedTypes);
+            const transaction = normalizeDocumentParagraphIdentities(view.state, trackedTypes, rotateTextId);
             if (transaction) {
                 transaction.setMeta('addToHistory', false);
                 view.dispatch(transaction);
@@ -6789,16 +6790,16 @@ function createDocumentParagraphIdentityPlugin(types) {
         },
         appendTransaction (transactions, oldState, newState) {
             if (!transactions.some((transaction)=>transaction.docChanged)) return null;
-            return normalizeDocumentParagraphIdentities(newState, trackedTypes, oldState, transactions);
+            return normalizeDocumentParagraphIdentities(newState, trackedTypes, rotateTextId, oldState, transactions);
         }
     });
 }
-function normalizeDocumentParagraphIdentities(state, trackedTypes, oldState, transactions = []) {
+function normalizeDocumentParagraphIdentities(state, trackedTypes, rotateTextId, oldState, transactions = []) {
     const paragraphs = documentParagraphs(state.doc, trackedTypes);
     const identifiedParagraphs = paragraphs.filter(({ node })=>hasDocumentParagraphIdentityComponent(node));
     if (!identifiedParagraphs.length) return null;
     const retainedPositions = oldState ? retainedDocumentParagraphPositions(oldState, state, transactions, trackedTypes) : new Set();
-    const editedPositions = oldState && !transactions.some(isHistoryTransaction) ? editedDocumentParagraphPositions(oldState, state, transactions, trackedTypes) : new Set();
+    const editedPositions = oldState && rotateTextId() && !transactions.some(isHistoryTransaction) ? editedDocumentParagraphPositions(oldState, state, transactions, trackedTypes) : new Set();
     const ordered = [
         ...identifiedParagraphs.filter((item)=>retainedPositions.has(item.position)),
         ...identifiedParagraphs.filter((item)=>!retainedPositions.has(item.position))
@@ -6971,6 +6972,11 @@ const DOCUMENT_TABLE_ROW_ID_ATTRIBUTE = 'data-office-row-id';
 const DOCUMENT_TABLE_ROW_TEXT_ID_ATTRIBUTE = 'data-office-row-text-id';
 const DocumentTableRowIdentity = Extension.create({
     name: 'documentTableRowIdentity',
+    addOptions () {
+        return {
+            rotateTextId: ()=>true
+        };
+    },
     addGlobalAttributes () {
         return [
             {
@@ -6986,7 +6992,7 @@ const DocumentTableRowIdentity = Extension.create({
     },
     addProseMirrorPlugins () {
         return [
-            createDocumentTableRowIdentityPlugin()
+            createDocumentTableRowIdentityPlugin(this.options.rotateTextId)
         ];
     }
 });
@@ -7028,10 +7034,10 @@ function identityAttribute(htmlName) {
         }
     };
 }
-function createDocumentTableRowIdentityPlugin() {
+function createDocumentTableRowIdentityPlugin(rotateTextId) {
     return new Plugin({
         view (view) {
-            const transaction = normalizeDocumentTableRowIdentities(view.state);
+            const transaction = normalizeDocumentTableRowIdentities(view.state, rotateTextId);
             if (transaction) {
                 transaction.setMeta('addToHistory', false);
                 view.dispatch(transaction);
@@ -7040,16 +7046,16 @@ function createDocumentTableRowIdentityPlugin() {
         },
         appendTransaction (transactions, oldState, newState) {
             if (!transactions.some((transaction)=>transaction.docChanged)) return null;
-            return normalizeDocumentTableRowIdentities(newState, oldState, transactions);
+            return normalizeDocumentTableRowIdentities(newState, rotateTextId, oldState, transactions);
         }
     });
 }
-function normalizeDocumentTableRowIdentities(state, oldState, transactions = []) {
+function normalizeDocumentTableRowIdentities(state, rotateTextId, oldState, transactions = []) {
     const rows = documentTableRows(state.doc);
     const identifiedRows = rows.filter(({ node })=>hasDocumentTableRowIdentityComponent(node));
     if (!identifiedRows.length) return null;
     const retainedPositions = oldState ? retainedDocumentTableRowPositions(oldState, state, transactions) : new Set();
-    const editedPositions = oldState && !transactions.some(isHistoryTransaction) ? editedDocumentTableRowPositions(oldState, state, transactions) : new Set();
+    const editedPositions = oldState && rotateTextId() && !transactions.some(isHistoryTransaction) ? editedDocumentTableRowPositions(oldState, state, transactions) : new Set();
     const ordered = [
         ...identifiedRows.filter((item)=>retainedPositions.has(item.position)),
         ...identifiedRows.filter((item)=>!retainedPositions.has(item.position))
@@ -8410,6 +8416,13 @@ const DocumentChange = Mark.create({
                         'data-change-id': attributes.id
                     })
             },
+            actorId: {
+                default: '',
+                parseHTML: (element)=>element.getAttribute('data-change-actor-id') ?? '',
+                renderHTML: (attributes)=>attributes.actorId ? {
+                        'data-change-actor-id': attributes.actorId
+                    } : {}
+            },
             author: {
                 default: '',
                 parseHTML: (element)=>element.getAttribute('data-change-author') ?? '',
@@ -8451,10 +8464,12 @@ const DocumentChange = Mark.create({
             acceptDocumentChange: (id)=>(props)=>resolveDocumentChangesCommand(props, this.type, 'accept', new Set([
                         id
                     ])) > 0,
+            acceptDocumentChanges: (ids)=>(props)=>resolveDocumentChangesCommand(props, this.type, 'accept', new Set(ids)) > 0,
             rejectAllDocumentChanges: ()=>(props)=>resolveDocumentChangesCommand(props, this.type, 'reject') > 0,
             rejectDocumentChange: (id)=>(props)=>resolveDocumentChangesCommand(props, this.type, 'reject', new Set([
                         id
                     ])) > 0,
+            rejectDocumentChanges: (ids)=>(props)=>resolveDocumentChangesCommand(props, this.type, 'reject', new Set(ids)) > 0,
             replaceDocumentTextWithTrackedChange: (from, to, text)=>({ state, tr })=>{
                     if (from < 0 || to < from || to > state.doc.content.size) return false;
                     trackedReplacement(tr, state.doc, this.type, from, to, text, this.options.createChange);
@@ -8537,6 +8552,9 @@ function collectDocumentChanges(document1) {
         changes.set(key, {
             id,
             kind,
+            ...work_document_changes_stringAttribute(mark.attrs.actorId) ? {
+                actorId: work_document_changes_stringAttribute(mark.attrs.actorId)
+            } : {},
             author: work_document_changes_stringAttribute(mark.attrs.author) || '未知审阅者',
             date: work_document_changes_stringAttribute(mark.attrs.date),
             from: position,
@@ -8640,6 +8658,7 @@ function changeMark(type, kind, createChange) {
     return type.create({
         kind,
         id: identity.id || createDocumentChangeId(),
+        actorId: identity.actorId ?? '',
         author: identity.author || 'A3S Work',
         date: identity.date || new Date().toISOString()
     });
@@ -15597,7 +15616,9 @@ function createWorkDocumentExtensions(options = {}) {
         DocumentTableCell,
         DocumentTableHeader,
         DocumentTableRow,
-        DocumentTableRowIdentity,
+        DocumentTableRowIdentity.configure({
+            rotateTextId: options.rotateTrackedTextIdentities ?? (()=>true)
+        }),
         DocumentTableCommands,
         DocumentTableFormatting,
         DocumentTableSizing,
@@ -15614,7 +15635,9 @@ function createWorkDocumentExtensions(options = {}) {
                 'paragraph'
             ]
         }),
-        DocumentParagraphIdentity,
+        DocumentParagraphIdentity.configure({
+            rotateTextId: options.rotateTrackedTextIdentities ?? (()=>true)
+        }),
         DocumentParagraphFormatting,
         DocumentParagraphTabStops,
         DocumentTab,
@@ -15864,6 +15887,142 @@ function deniedImmutableRecord(label) {
 function deniedReviewMutation(session) {
     throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', `The '${session.mode}' collaboration mode cannot modify Document review records.`);
 }
+function validatedWorkOfficeDocumentChangeDecisions(value) {
+    if (!Array.isArray(value)) invalidInputSidecars('an array of tracked-change decisions');
+    const ids = new Set();
+    const changes = new Set();
+    return value.map((candidate)=>{
+        const decision = validatedDecision(candidate);
+        if (ids.has(decision.id)) invalidInputSidecars(`a unique tracked-change decision ID; '${decision.id}' is repeated`);
+        const change = changeIdentity(decision);
+        if (changes.has(change)) invalidInputSidecars(`one final decision for tracked change '${decision.changeId}'`);
+        ids.add(decision.id);
+        changes.add(change);
+        return decision;
+    });
+}
+function initializeWorkOfficeDocumentChangeDecisions(records, order, decisions) {
+    for (const decision of decisions){
+        createDecisionRecord(records, decision);
+        order.push([
+            decision.id
+        ]);
+    }
+}
+function readWorkOfficeDocumentChangeDecisions(records, order) {
+    const decisions = validatedOrder(order, records, 'tracked-change decision').map((id)=>readDecisionRecord(requiredSharedMap(records, id, 'tracked-change decision'), id));
+    const changes = new Set();
+    for (const decision of decisions){
+        const identity = changeIdentity(decision);
+        if (changes.has(identity)) invalidSharedSidecars(`multiple final decisions for tracked change '${decision.changeId}'`);
+        changes.add(identity);
+    }
+    return decisions;
+}
+function patchWorkOfficeDocumentChangeDecisions(records, order, previous, next) {
+    const beforeById = new Map(previous.map((decision)=>[
+            decision.id,
+            decision
+        ]));
+    for (const decision of previous){
+        const candidate = next.find(({ id })=>id === decision.id);
+        if (!candidate || !jsonEqual(candidate, decision)) immutableDecision(decision.id);
+    }
+    for (const decision of next)if (!beforeById.has(decision.id)) {
+        if (!records.has(decision.id)) createDecisionRecord(records, decision);
+        insertIntoOrder(order, next.map(({ id })=>id), decision.id);
+    }
+}
+function assertWorkOfficeDocumentChangeDecisionConflicts(previous, next, shared) {
+    assertNoAddedCollision(previous, next, shared, 'tracked-change decision');
+    const nextById = new Map(next.map((decision)=>[
+            decision.id,
+            decision
+        ]));
+    for (const decision of previous)if (!jsonEqual(nextById.get(decision.id), decision)) immutableDecision(decision.id);
+    const sharedByChange = new Map(shared.map((decision)=>[
+            changeIdentity(decision),
+            decision
+        ]));
+    const previousIds = new Set(previous.map(({ id })=>id));
+    for (const decision of next){
+        if (previousIds.has(decision.id)) continue;
+        const current = sharedByChange.get(changeIdentity(decision));
+        if (current && !jsonEqual(current, decision)) throw new WorkOfficeCollaborationError('office.collaboration.content_invalid', `Tracked change '${decision.changeId}' already has a different final decision.`);
+    }
+}
+function validatedDecision(value) {
+    if (!office_document_collaboration_sidecar_utils_isRecord(value)) invalidInputSidecars('valid tracked-change decision records');
+    const decision = {
+        id: requiredIdentifier(value.id, 'tracked-change decision'),
+        changeId: requiredIdentifier(value.changeId, 'tracked change'),
+        changeKind: office_document_collaboration_change_decisions_changeKind(value.changeKind, false),
+        suggestedBy: requiredString(value.suggestedBy, 'suggestion author'),
+        suggestedAt: requiredString(value.suggestedAt, 'suggestion date'),
+        text: requiredString(value.text, 'suggestion text'),
+        decision: decisionAction(value.decision, false),
+        decidedBy: requiredString(value.decidedBy, 'decision author'),
+        decidedAt: requiredString(value.decidedAt, 'decision date')
+    };
+    if (void 0 !== value.suggestedByActorId) decision.suggestedByActorId = requiredIdentifier(value.suggestedByActorId, 'suggestion actor');
+    if (void 0 !== value.decidedByActorId) decision.decidedByActorId = requiredIdentifier(value.decidedByActorId, 'decision actor');
+    return decision;
+}
+function createDecisionRecord(records, decision) {
+    const record = new __rspack_external_yjs.Map();
+    records.set(decision.id, record);
+    for (const [key, value] of Object.entries(decision))record.set(key, value);
+}
+function readDecisionRecord(record, expectedId) {
+    const id = requiredSharedIdentifier(record.get('id'), 'tracked-change decision');
+    if (id !== expectedId) invalidSharedSidecars('tracked-change decision identity');
+    const allowed = new Set([
+        'id',
+        'changeId',
+        'changeKind',
+        'suggestedByActorId',
+        'suggestedBy',
+        'suggestedAt',
+        'text',
+        'decision',
+        'decidedByActorId',
+        'decidedBy',
+        'decidedAt'
+    ]);
+    if (Array.from(record.keys()).some((key)=>!allowed.has(key))) invalidSharedSidecars('tracked-change decision fields');
+    const decision = {
+        id,
+        changeId: requiredSharedIdentifier(record.get('changeId'), 'tracked change'),
+        changeKind: office_document_collaboration_change_decisions_changeKind(record.get('changeKind'), true),
+        suggestedBy: requiredSharedString(record.get('suggestedBy'), 'suggestion author'),
+        suggestedAt: requiredSharedString(record.get('suggestedAt'), 'suggestion date'),
+        text: requiredSharedString(record.get('text'), 'suggestion text'),
+        decision: decisionAction(record.get('decision'), true),
+        decidedBy: requiredSharedString(record.get('decidedBy'), 'decision author'),
+        decidedAt: requiredSharedString(record.get('decidedAt'), 'decision date')
+    };
+    const suggestedByActorId = record.get('suggestedByActorId');
+    if (void 0 !== suggestedByActorId) decision.suggestedByActorId = requiredSharedIdentifier(suggestedByActorId, 'suggestion actor');
+    const decidedByActorId = record.get('decidedByActorId');
+    if (void 0 !== decidedByActorId) decision.decidedByActorId = requiredSharedIdentifier(decidedByActorId, 'decision actor');
+    return decision;
+}
+function changeIdentity(decision) {
+    return `${decision.changeKind}:${decision.changeId}`;
+}
+function office_document_collaboration_change_decisions_changeKind(value, shared) {
+    if ('insertion' === value || 'deletion' === value) return value;
+    if (shared) invalidSharedSidecars('tracked-change decision kind');
+    invalidInputSidecars('an insertion or deletion tracked-change kind');
+}
+function decisionAction(value, shared) {
+    if ('accept' === value || 'reject' === value) return value;
+    if (shared) invalidSharedSidecars('tracked-change decision action');
+    invalidInputSidecars('an accept or reject tracked-change decision');
+}
+function immutableDecision(id) {
+    throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', `Tracked-change decision '${id}' is immutable and cannot be rewritten or removed.`);
+}
 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');
@@ -16216,6 +16375,8 @@ function optionalSharedIdentifier(value, label) {
     return void 0 === value ? void 0 : requiredSharedIdentifier(value, label);
 }
 function appendWorkOfficeDocumentRecordClaims(claims, previous, next) {
+    const previousDecisions = new Set((previous.changeDecisions ?? []).map((decision)=>decision.id));
+    for (const decision of next.changeDecisions ?? [])if (!previousDecisions.has(decision.id)) appendClaim(claims, 'change-decision', decision.id, decision);
     const previousComments = new Map((previous.comments ?? []).map((comment)=>[
             comment.id,
             comment
@@ -16238,6 +16399,7 @@ function assertWorkOfficeDocumentRecordClaims(claims, sidecars) {
         if (void 0 !== existing && existing !== claim.fingerprint) throw new WorkOfficeCollaborationError('office.collaboration.content_invalid', `The ${claimLabel(claim)} ID '${claim.id}' was concurrently assigned to different records.`);
         fingerprints.set(identity, claim.fingerprint);
     }
+    for (const decision of sidecars.changeDecisions ?? [])assertClaimExists(fingerprints, 'change-decision', decision.id);
     for (const comment of sidecars.comments ?? []){
         assertClaimExists(fingerprints, 'comment', comment.id);
         for (const reply of comment.replies ?? [])assertClaimExists(fingerprints, 'comment-reply', reply.id, comment.id);
@@ -16269,7 +16431,7 @@ function parsedClaim(rawClaim) {
     const keys = Object.keys(value);
     if (keys.some((key)=>'fingerprint' !== key && 'id' !== key && 'kind' !== key && 'parentId' !== key)) invalidSharedSidecars('record claim');
     const kind = value.kind;
-    if ('bibliography-source' !== kind && 'comment' !== kind && 'comment-reply' !== kind) invalidSharedSidecars('record claim kind');
+    if ('bibliography-source' !== kind && 'change-decision' !== kind && 'comment' !== kind && 'comment-reply' !== kind) invalidSharedSidecars('record claim kind');
     const id = requiredSharedIdentifier(value.id, 'record claim');
     const fingerprint = requiredSharedString(value.fingerprint, 'record claim fingerprint');
     const parentId = void 0 === value.parentId ? void 0 : requiredSharedIdentifier(value.parentId, 'record claim parent');
@@ -16302,6 +16464,7 @@ function claimIdentity(kind, id, parentId) {
     ]);
 }
 function claimLabel(claim) {
+    if ('change-decision' === claim.kind) return 'tracked-change decision';
     if ('comment' === claim.kind) return 'comment';
     if ('bibliography-source' === claim.kind) return 'bibliography source';
     return `reply in comment '${claim.parentId}'`;
@@ -16309,13 +16472,15 @@ function claimLabel(claim) {
 const DOCUMENT_OPTIONS_ROOT = 'document.options';
 const DOCUMENT_COMMENTS_ROOT = 'document.comments';
 const DOCUMENT_COMMENT_ORDER_ROOT = 'document.comment-order';
+const DOCUMENT_CHANGE_DECISIONS_ROOT = 'document.change-decisions';
+const DOCUMENT_CHANGE_DECISION_ORDER_ROOT = 'document.change-decision-order';
 const DOCUMENT_BIBLIOGRAPHY_ROOT = 'document.bibliography';
 const DOCUMENT_BIBLIOGRAPHY_SOURCES_ROOT = 'document.bibliography.sources';
 const DOCUMENT_BIBLIOGRAPHY_SOURCE_ORDER_ROOT = 'document.bibliography.source-order';
 const DOCUMENT_RECORD_CLAIMS_ROOT = 'document.record-claims';
 function assertWorkOfficeDocumentSidecarsEmpty(session) {
     const roots = documentSidecarRoots(session);
-    if (roots.options.size > 0 || roots.comments.size > 0 || roots.commentOrder.length > 0 || roots.bibliography.size > 0 || roots.bibliographySources.size > 0 || roots.bibliographySourceOrder.length > 0 || roots.recordClaims.length > 0) throw new WorkOfficeCollaborationError('office.collaboration.bootstrap_ambiguous', 'The Document collaboration sidecars contain data without initialized metadata.');
+    if (roots.options.size > 0 || roots.comments.size > 0 || roots.commentOrder.length > 0 || roots.changeDecisions.size > 0 || roots.changeDecisionOrder.length > 0 || roots.bibliography.size > 0 || roots.bibliographySources.size > 0 || roots.bibliographySourceOrder.length > 0 || roots.recordClaims.length > 0) throw new WorkOfficeCollaborationError('office.collaboration.bootstrap_ambiguous', 'The Document collaboration sidecars contain data without initialized metadata.');
 }
 function initializeWorkOfficeDocumentSidecars(session, content) {
     const roots = documentSidecarRoots(session);
@@ -16323,6 +16488,7 @@ function initializeWorkOfficeDocumentSidecars(session, content) {
     appendWorkOfficeDocumentRecordClaims(roots.recordClaims, {}, sidecars);
     if (void 0 !== sidecars.pageColor) roots.options.set('pageColor', sidecars.pageColor);
     if (void 0 !== sidecars.trackChanges) roots.options.set('trackChanges', sidecars.trackChanges);
+    if (void 0 !== sidecars.changeDecisions) initializeWorkOfficeDocumentChangeDecisions(roots.changeDecisions, roots.changeDecisionOrder, sidecars.changeDecisions);
     if (void 0 !== sidecars.comments) {
         roots.options.set('commentsPresent', true);
         initializeWorkOfficeDocumentComments(roots.comments, roots.commentOrder, sidecars.comments);
@@ -16345,6 +16511,8 @@ function readWorkOfficeDocumentSidecars(session) {
         if ('boolean' != typeof trackChanges) invalidSharedSidecars('track-changes setting');
         result.trackChanges = trackChanges;
     }
+    if (roots.changeDecisionOrder.length > 0) result.changeDecisions = readWorkOfficeDocumentChangeDecisions(roots.changeDecisions, roots.changeDecisionOrder);
+    else if (roots.changeDecisions.size > 0) invalidSharedSidecars('tracked-change decision order and record set');
     const commentsPresent = optionalPresence(roots.options.get('commentsPresent'), 'comment');
     if (true === commentsPresent || roots.commentOrder.length > 0) result.comments = readWorkOfficeDocumentComments(roots.comments, roots.commentOrder);
     else if (roots.comments.size > 0) invalidSharedSidecars('comment order and record set');
@@ -16362,11 +16530,13 @@ function updateWorkOfficeDocumentSidecars(session, previous, next, origin) {
     const roots = documentSidecarRoots(session);
     const shared = readWorkOfficeDocumentSidecars(session);
     assertWorkOfficeDocumentCommentConflicts(before.comments ?? [], after.comments ?? [], shared.comments ?? []);
+    assertWorkOfficeDocumentChangeDecisionConflicts(before.changeDecisions ?? [], after.changeDecisions ?? [], shared.changeDecisions ?? []);
     assertWorkOfficeDocumentBibliographyConflicts(before.bibliography, after.bibliography, shared.bibliography);
     session.transact(()=>{
         appendWorkOfficeDocumentRecordClaims(roots.recordClaims, before, after);
         patchOptionalScalar(roots.options, 'pageColor', before.pageColor, after.pageColor);
         patchOptionalScalar(roots.options, 'trackChanges', before.trackChanges, after.trackChanges);
+        if (!jsonEqual(before.changeDecisions, after.changeDecisions)) patchWorkOfficeDocumentChangeDecisions(roots.changeDecisions, roots.changeDecisionOrder, before.changeDecisions ?? [], after.changeDecisions ?? []);
         if (!jsonEqual(before.comments, after.comments)) {
             patchPresence(roots.options, 'commentsPresent', before.comments, after.comments);
             patchWorkOfficeDocumentComments(roots.comments, roots.commentOrder, before.comments ?? [], after.comments ?? []);
@@ -16390,9 +16560,19 @@ function workOfficeDocumentSidecarUndoScope(session) {
         roots.recordClaims
     ];
 }
+function workOfficeDocumentDecisionRootsChanged(session, transaction) {
+    const roots = documentSidecarRoots(session);
+    const changed = new Set(transaction.changedParentTypes.keys());
+    return changed.has(roots.changeDecisions) || changed.has(roots.changeDecisionOrder);
+}
 function workOfficeDocumentSidecarsChanged(session, transaction) {
     const changed = new Set(transaction.changedParentTypes.keys());
-    return workOfficeDocumentSidecarUndoScope(session).some((root)=>changed.has(root));
+    const roots = documentSidecarRoots(session);
+    return [
+        ...workOfficeDocumentSidecarUndoScope(session),
+        roots.changeDecisions,
+        roots.changeDecisionOrder
+    ].some((root)=>changed.has(root));
 }
 function validatedWorkOfficeDocumentSidecars(content) {
     if (!content || 'document' !== content.type) invalidInputSidecars('a Document content value');
@@ -16405,6 +16585,7 @@ function validatedWorkOfficeDocumentSidecars(content) {
         if ('boolean' != typeof content.trackChanges) invalidInputSidecars('a boolean track-changes setting');
         result.trackChanges = content.trackChanges;
     }
+    if (void 0 !== content.changeDecisions) result.changeDecisions = validatedWorkOfficeDocumentChangeDecisions(content.changeDecisions);
     if (void 0 !== content.comments) result.comments = validatedWorkOfficeDocumentComments(content.comments);
     if (void 0 !== content.bibliography) result.bibliography = validatedWorkOfficeDocumentBibliography(content.bibliography);
     return result;
@@ -16412,7 +16593,7 @@ function validatedWorkOfficeDocumentSidecars(content) {
 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.');
+    if (!jsonEqual(previous.pageColor, next.pageColor) || !jsonEqual(previous.trackChanges, next.trackChanges) || !jsonEqual(previous.changeDecisions, next.changeDecisions) || !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) {
@@ -16420,6 +16601,8 @@ function documentSidecarRoots(session) {
         options: session.document.getMap(session.rootName(DOCUMENT_OPTIONS_ROOT)),
         comments: session.document.getMap(session.rootName(DOCUMENT_COMMENTS_ROOT)),
         commentOrder: session.document.getArray(session.rootName(DOCUMENT_COMMENT_ORDER_ROOT)),
+        changeDecisions: session.document.getMap(session.rootName(DOCUMENT_CHANGE_DECISIONS_ROOT)),
+        changeDecisionOrder: session.document.getArray(session.rootName(DOCUMENT_CHANGE_DECISION_ORDER_ROOT)),
         bibliography: session.document.getMap(session.rootName(DOCUMENT_BIBLIOGRAPHY_ROOT)),
         bibliographySources: session.document.getMap(session.rootName(DOCUMENT_BIBLIOGRAPHY_SOURCES_ROOT)),
         bibliographySourceOrder: session.document.getArray(session.rootName(DOCUMENT_BIBLIOGRAPHY_SOURCE_ORDER_ROOT)),
@@ -16436,6 +16619,152 @@ function patchPresence(target, key, previous, next, absentValue) {
     else if (void 0 !== previous) if (false === absentValue) target.set(key, false);
     else target.delete(key);
 }
+function workOfficeDocumentSuggestionTransactionAllowed(session, transaction) {
+    const actor = session.actor;
+    if (!actor || !transaction.docChanged || 0 === transaction.steps.length) return false;
+    if (!transaction.steps.every((step)=>step instanceof ReplaceStep || (step instanceof AddMarkStep || step instanceof RemoveMarkStep) && 'documentChange' === step.mark.type.name)) return false;
+    const before = strictDocumentChanges(transaction.before);
+    const after = strictDocumentChanges(transaction.doc);
+    if (!before || !after) return false;
+    if (JSON.stringify(documentSuggestionBaseline(transaction.before)) !== JSON.stringify(documentSuggestionBaseline(transaction.doc))) return false;
+    const beforeById = new Map(before.map((change)=>[
+            change.id,
+            change
+        ]));
+    const afterById = new Map(after.map((change)=>[
+            change.id,
+            change
+        ]));
+    for (const previous of before){
+        const current = afterById.get(previous.id);
+        if (!current) {
+            if (previous.actorId !== actor.id) return false;
+            continue;
+        }
+        if (!sameChangeIdentity(previous, current)) return false;
+        if (previous.actorId !== actor.id && previous.text !== current.text) return false;
+        if (previous.actorId === actor.id && 'deletion' === previous.kind && previous.text !== current.text) return false;
+    }
+    for (const current of after)if (!beforeById.has(current.id)) {
+        if (current.actorId !== actor.id || current.author !== actor.name || !current.date || !current.text) return false;
+    }
+    return true;
+}
+function createWorkOfficeDocumentChangeDecisions(session, changes, decision, decidedAt = new Date().toISOString()) {
+    const decidedBy = session.actor?.name ?? 'A3S Work 用户';
+    return changes.map((change)=>({
+            id: `${change.kind}:${change.id}`,
+            changeId: change.id,
+            changeKind: change.kind,
+            ...change.actorId ? {
+                suggestedByActorId: change.actorId
+            } : {},
+            suggestedBy: change.author,
+            suggestedAt: change.date,
+            text: change.text,
+            decision,
+            ...session.actor ? {
+                decidedByActorId: session.actor.id
+            } : {},
+            decidedBy,
+            decidedAt
+        }));
+}
+function strictDocumentChanges(document1) {
+    const changes = new Map();
+    let valid = true;
+    document1.descendants((node)=>{
+        if (!valid || !node.isText || !node.text) return;
+        const marks = node.marks.filter((mark)=>'documentChange' === mark.type.name);
+        if (0 === marks.length) return;
+        if (1 !== marks.length) {
+            valid = false;
+            return false;
+        }
+        const mark = marks[0];
+        const id = strictString(mark.attrs.id);
+        const kind = strictChangeKind(mark.attrs.kind);
+        const author = strictString(mark.attrs.author);
+        const date = strictString(mark.attrs.date);
+        const actorId = optionalStrictString(mark.attrs.actorId);
+        if (!id || !kind || null === author || null === date || null === actorId) {
+            valid = false;
+            return false;
+        }
+        const current = changes.get(id);
+        const candidate = {
+            id,
+            kind,
+            ...actorId ? {
+                actorId
+            } : {},
+            author,
+            date,
+            text: node.text
+        };
+        if (!current) return void changes.set(id, candidate);
+        if (!sameChangeIdentity(current, candidate)) {
+            valid = false;
+            return false;
+        }
+        current.text += node.text;
+    });
+    return valid ? Array.from(changes.values()) : null;
+}
+function documentSuggestionBaseline(node) {
+    const json = node.toJSON();
+    if (node.isText) {
+        const change = node.marks.find((mark)=>'documentChange' === mark.type.name);
+        if (change?.attrs.kind === 'insertion') return null;
+        const marks = node.marks.filter((mark)=>'documentChange' !== mark.type.name).map((mark)=>mark.toJSON());
+        if (marks.length > 0) return {
+            ...json,
+            marks
+        };
+        const { marks: _marks, ...withoutMarks } = json;
+        return withoutMarks;
+    }
+    const content = [];
+    node.forEach((child)=>{
+        const projected = documentSuggestionBaseline(child);
+        if (null !== projected) appendSuggestionBaselineNode(content, projected);
+    });
+    if (content.length > 0) return {
+        ...json,
+        content
+    };
+    const { content: _content, ...withoutContent } = json;
+    return withoutContent;
+}
+function appendSuggestionBaselineNode(content, projected) {
+    const previous = content.at(-1);
+    if (isSuggestionBaselineText(previous) && isSuggestionBaselineText(projected) && JSON.stringify(previous.marks ?? []) === JSON.stringify(projected.marks ?? [])) {
+        content[content.length - 1] = {
+            ...previous,
+            text: previous.text + projected.text
+        };
+        return;
+    }
+    content.push(projected);
+}
+function isSuggestionBaselineText(value) {
+    if (!value || 'object' != typeof value) return false;
+    const candidate = value;
+    return 'text' === candidate.type && 'string' == typeof candidate.text;
+}
+function sameChangeIdentity(left, right) {
+    return left.id === right.id && left.kind === right.kind && left.actorId === right.actorId && left.author === right.author && left.date === right.date;
+}
+function strictString(value) {
+    return 'string' == typeof value && value.trim() === value && value ? value : null;
+}
+function optionalStrictString(value) {
+    if (void 0 === value || '' === value) return;
+    return strictString(value);
+}
+function strictChangeKind(value) {
+    return 'insertion' === value || 'deletion' === value ? value : null;
+}
 const DOCUMENT_CONTENT_ROOT = 'document.content';
 const MAX_DOCUMENT_COMMENT_HISTORY = 100;
 const mountedDocumentBindings = new WeakMap();
@@ -16518,7 +16847,8 @@ class WorkOfficeDocumentCollaborationBindingImpl {
         assertWorkOfficeCollaborationOrigin(this.origin);
         const builtIns = createWorkDocumentExtensions({
             ...options.workExtensions,
-            collaborative: true
+            collaborative: true,
+            rotateTrackedTextIdentities: ()=>'suggest' !== session.mode
         });
         const additional = options.additionalExtensions ?? [];
         assertBehaviorOnlyExtensions(additional);
@@ -16541,7 +16871,7 @@ 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.');
-        const undoScope = 'comment' === session.mode ? [
+        const undoScope = 'comment' === session.mode || 'suggest' === session.mode ? [
             this.fragment
         ] : [
             this.fragment,
@@ -16559,7 +16889,7 @@ class WorkOfficeDocumentCollaborationBindingImpl {
         const restore = restorable.restore?.bind(this.#undoManager);
         if (restore) restorable.restore = ()=>{
             restore();
-            this.#undoManager.addToScope('comment' === this.#session.mode ? this.fragment : [
+            this.#undoManager.addToScope('comment' === this.#session.mode || 'suggest' === this.#session.mode ? this.fragment : [
                 this.fragment,
                 ...workOfficeDocumentSidecarUndoScope(this.#session)
             ]);
@@ -16602,6 +16932,36 @@ class WorkOfficeDocumentCollaborationBindingImpl {
         }
         return changed;
     }
+    decideChanges(editor, changeIds, decision, options = {}) {
+        this.ensureActive();
+        assertWorkOfficeCollaborationEditable(this.#session);
+        if (editor.isDestroyed || 0 === changeIds.length) return false;
+        const requested = new Set(changeIds);
+        const changes = collectDocumentChanges(editor.state.doc).filter((change)=>requested.has(change.id));
+        if (changes.length !== requested.size) return false;
+        const before = this.content();
+        const decisions = createWorkOfficeDocumentChangeDecisions(this.#session, changes, decision, options.decidedAt);
+        const existing = new Set((before.changeDecisions ?? []).map(({ id })=>id));
+        if (decisions.some(({ id })=>existing.has(id))) throw new WorkOfficeCollaborationError('office.collaboration.permission_denied', 'A tracked change with a final decision cannot be decided again.');
+        const origin = this.#session.createOrigin(this.#session.localOrigin.kind);
+        let handled = false;
+        this.#session.transact(()=>{
+            handled = 'accept' === decision ? editor.commands.acceptDocumentChanges(changeIds) : editor.commands.rejectDocumentChanges(changeIds);
+            if (!handled) return;
+            updateWorkOfficeDocumentSidecars(this.#session, before, {
+                ...before,
+                changeDecisions: [
+                    ...before.changeDecisions ?? [],
+                    ...decisions
+                ]
+            }, origin);
+        }, origin);
+        if (handled) {
+            this.#undoManager.clear();
+            this.#onHistoryChange();
+        }
+        return handled;
+    }
     canUndo() {
         this.ensureActive();
         if ('comment' === this.#session.mode) return this.#commentUndoStack.length > 0 || this.#undoManager.canUndo();
@@ -16618,6 +16978,10 @@ class WorkOfficeDocumentCollaborationBindingImpl {
             assertWorkOfficeCollaborationWritable(this.#session, 'document-comment');
             return this.applyCommentHistory('undo');
         }
+        if ('suggest' === this.#session.mode) {
+            assertWorkOfficeCollaborationWritable(this.#session, 'document-suggestion');
+            return null !== this.#undoManager.undo();
+        }
         assertWorkOfficeCollaborationEditable(this.#session);
         return null !== this.#undoManager.undo();
     }
@@ -16627,6 +16991,10 @@ class WorkOfficeDocumentCollaborationBindingImpl {
             assertWorkOfficeCollaborationWritable(this.#session, 'document-comment');
             return this.applyCommentHistory('redo');
         }
+        if ('suggest' === this.#session.mode) {
+            assertWorkOfficeCollaborationWritable(this.#session, 'document-suggestion');
+            return null !== this.#undoManager.redo();
+        }
         assertWorkOfficeCollaborationEditable(this.#session);
         return null !== this.#undoManager.redo();
     }
@@ -16669,6 +17037,10 @@ class WorkOfficeDocumentCollaborationBindingImpl {
         if (transaction.origin === ySyncPluginKey) transaction.origin = this.origin;
     };
     #onTransaction = (transaction)=>{
+        if ('suggest' === this.#session.mode && workOfficeDocumentDecisionRootsChanged(this.#session, transaction)) {
+            this.#undoManager.clear();
+            this.#onHistoryChange();
+        }
         if (this.#destroyed || this.#destroyRequested || !transactionTouchesRoot(transaction, this.fragment) && !workOfficeDocumentSidecarsChanged(this.#session, transaction)) return;
         const local = transaction.origin === ySyncPluginKey || transaction.origin === this.origin || transaction.origin === this.#undoManager;
         this.#pendingLocal = this.#pendingChange ? this.#pendingLocal && local : local;
@@ -16944,7 +17316,7 @@ function documentCollaborationPermissionExtension(session) {
             return [
                 new Plugin({
                     filterTransaction (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);
+                        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) || 'suggest' === session.mode && workOfficeDocumentSuggestionTransactionAllowed(session, transaction);
                     }
                 })
             ];