@univerjs/sheets-thread-comment 0.6.1 → 0.6.2

package/lib/cjs/facade.js

@@ -1 +1 @@
-"use strict";var T=Object.defineProperty;var E=(I,e,o)=>e in I?T(I,e,{enumerable:!0,configurable:!0,writable:!0,value:o}):I[e]=o;var R=(I,e,o)=>E(I,typeof e!="symbol"?e+"":e,o);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("@univerjs/core"),b=require("@univerjs/sheets-thread-comment"),f=require("@univerjs/sheets/facade"),a=require("@univerjs/thread-comment"),y=require("@univerjs/engine-formula"),x=require("rxjs"),S=require("@univerjs/core/facade");var A=Object.getOwnPropertyDescriptor,B=(I,e,o,t)=>{for(var n=t>1?void 0:t?A(e,o):e,r=I.length-1,s;r>=0;r--)(s=I[r])&&(n=s(n)||n);return n},p=(I,e)=>(o,t)=>e(o,t,I);class U{constructor(e){R(this,"_comment",{id:m.generateRandomId(),ref:"",threadId:"",dT:"",personId:"",text:m.RichTextBuilder.newEmptyData().body,attachments:[],unitId:"",subUnitId:""});e&&(this._comment=e)}static create(e){return new U(e)}get personId(){return this._comment.personId}get dateTime(){return this._comment.dT}get content(){return m.RichTextValue.createByBody(this._comment.text)}get id(){return this._comment.id}get threadId(){return this._comment.threadId}copy(){return k.create(m.Tools.deepClone(this._comment))}}class k extends U{static create(e){return new k(e)}setContent(e){return e instanceof m.RichTextValue?this._comment.text=e.getData().body:this._comment.text=e,this}setPersonId(e){return this._comment.personId=e,this}setDateTime(e){return this._comment.dT=a.getDT(e),this}setId(e){return this._comment.id=e,this}setThreadId(e){return this._comment.threadId=e,this}build(){return this._comment}}exports.FThreadComment=class{constructor(e,o,t,n,r,s,c){this._thread=e,this._parent=o,this._injector=t,this._commandService=n,this._univerInstanceService=r,this._threadCommentModel=s,this._userManagerService=c}_getRef(){var t;const e=((t=this._parent)==null?void 0:t.ref)||this._thread.ref;return y.deserializeRangeWithSheet(e).range}getIsRoot(){return!this._parent}getCommentData(){const{children:e,...o}=this._thread;return o}getReplies(){var t;const e=this._getRef(),o=this._threadCommentModel.getCommentWithChildren(this._thread.unitId,this._thread.subUnitId,e.startRow,e.startColumn);return(t=o==null?void 0:o.children)==null?void 0:t.map(n=>this._injector.createInstance(exports.FThreadComment,n))}getRange(){const e=this._univerInstanceService.getUnit(this._thread.unitId,m.UniverInstanceType.UNIVER_SHEET);if(!e)return null;const o=e.getSheetBySheetId(this._thread.subUnitId);if(!o)return null;const t=this._getRef();return this._injector.createInstance(f.FRange,e,o,t)}getContent(){return this._thread.text}getRichText(){const e=this._thread.text;return m.RichTextValue.create({body:e,documentStyle:{},id:"d"})}deleteAsync(){return this._commandService.executeCommand(this.getIsRoot()?a.DeleteCommentTreeCommand.id:a.DeleteCommentCommand.id,{commentId:this._thread.id,unitId:this._thread.unitId,subUnitId:this._thread.subUnitId})}delete(){return this.deleteAsync()}async update(e){return this.updateAsync(e)}async updateAsync(e){const o=e instanceof m.RichTextValue?e.getData().body:e,t=a.getDT();return await this._commandService.executeCommand(a.UpdateCommentCommand.id,{unitId:this._thread.unitId,subUnitId:this._thread.subUnitId,payload:{commentId:this._thread.id,text:o,updated:!0,updateT:t}})}resolve(e){return this.resolveAsync(e)}resolveAsync(e){return this._commandService.executeCommand(a.ResolveCommentCommand.id,{unitId:this._thread.unitId,subUnitId:this._thread.subUnitId,commentId:this._thread.id,resolved:e!=null?e:!this._thread.resolved})}async replyAsync(e){var t;const o=e.build();return this._commandService.executeCommand(a.AddCommentCommand.id,{unitId:this._thread.unitId,subUnitId:this._thread.subUnitId,comment:{id:m.generateRandomId(),parentId:this._thread.id,threadId:this._thread.threadId,ref:(t=this._parent)==null?void 0:t.ref,unitId:this._thread.unitId,subUnitId:this._thread.subUnitId,text:o.text,attachments:o.attachments,dT:o.dT||a.getDT(),personId:o.personId||this._userManagerService.getCurrentUser().userID}})}};exports.FThreadComment=B([p(2,m.Inject(m.Injector)),p(3,m.ICommandService),p(4,m.IUniverInstanceService),p(5,m.Inject(b.SheetsThreadCommentModel)),p(6,m.Inject(m.UserManagerService))],exports.FThreadComment);class D extends f.FRange{getComment(){const o=this._injector.get(b.SheetsThreadCommentModel),t=this._workbook.getUnitId(),n=this._worksheet.getSheetId(),r=o.getByLocation(t,n,this._range.startRow,this._range.startColumn);if(!r)return null;const s=o.getComment(t,n,r);return s?this._injector.createInstance(exports.FThreadComment,s):null}getComments(){const o=this._injector.get(b.SheetsThreadCommentModel),t=this._workbook.getUnitId(),n=this._worksheet.getSheetId(),r=[];return m.Range.foreach(this._range,(s,c)=>{const u=o.getByLocation(t,n,s,c);if(u){const i=o.getComment(t,n,u);i&&r.push(this._injector.createInstance(exports.FThreadComment,i))}}),r}addComment(e){var h;const o=this._injector,t=(h=this.getComment())==null?void 0:h.getCommentData(),n=o.get(m.ICommandService),r=o.get(m.UserManagerService),s=this._workbook.getUnitId(),c=this._worksheet.getSheetId(),u=`${m.Tools.chatAtABC(this._range.startColumn)}${this._range.startRow+1}`,i=r.getCurrentUser(),d=e instanceof k?e.build():{text:e};return n.executeCommand(a.AddCommentCommand.id,{unitId:s,subUnitId:c,comment:{text:d.text,dT:d.dT||a.getDT(),attachments:[],id:d.id||m.generateRandomId(),ref:u,personId:d.personId||i.userID,parentId:t==null?void 0:t.id,unitId:s,subUnitId:c,threadId:(t==null?void 0:t.threadId)||m.generateRandomId()}})}clearComment(){var s;const e=this._injector,o=(s=this.getComment())==null?void 0:s.getCommentData(),t=e.get(m.ICommandService),n=this._workbook.getUnitId(),r=this._worksheet.getSheetId();return o?t.executeCommand(a.DeleteCommentTreeCommand.id,{unitId:n,subUnitId:r,threadId:o.threadId,commentId:o.id}):Promise.resolve(!0)}clearComments(){const o=this.getComments().map(t=>t.deleteAsync());return Promise.all(o).then(()=>!0)}addCommentAsync(e){return this.addComment(e)}clearCommentAsync(){return this.clearComment()}clearCommentsAsync(){return this.clearComments()}}f.FRange.extend(D);class j extends f.FWorkbook{_initialize(){Object.defineProperty(this,"_threadCommentModel",{get(){return this._injector.get(a.ThreadCommentModel)}})}getComments(){return this._threadCommentModel.getUnit(this._workbook.getUnitId()).map(e=>this._injector.createInstance(exports.FThreadComment,e.root))}clearComments(){const o=this.getComments().map(t=>t.deleteAsync());return Promise.all(o).then(()=>!0)}onThreadCommentChange(e){return m.toDisposable(this._threadCommentModel.commentUpdate$.pipe(x.filter(o=>o.unitId===this._workbook.getUnitId())).subscribe(e))}onBeforeAddThreadComment(e){return m.toDisposable(this._commandService.beforeCommandExecuted((o,t)=>{const n=o.params;if(o.id===a.AddCommentCommand.id){if(n.unitId!==this._workbook.getUnitId())return;if(e(n,t)===!1)throw new Error("Command is stopped by the hook onBeforeAddThreadComment")}}))}onBeforeUpdateThreadComment(e){return m.toDisposable(this._commandService.beforeCommandExecuted((o,t)=>{const n=o.params;if(o.id===a.UpdateCommentCommand.id){if(n.unitId!==this._workbook.getUnitId())return;if(e(n,t)===!1)throw new Error("Command is stopped by the hook onBeforeUpdateThreadComment")}}))}onBeforeDeleteThreadComment(e){return m.toDisposable(this._commandService.beforeCommandExecuted((o,t)=>{const n=o.params;if(o.id===a.DeleteCommentCommand.id||o.id===a.DeleteCommentTreeCommand.id){if(n.unitId!==this._workbook.getUnitId())return;if(e(n,t)===!1)throw new Error("Command is stopped by the hook onBeforeDeleteThreadComment")}}))}}f.FWorkbook.extend(j);class F extends f.FWorksheet{getComments(){return this._injector.get(b.SheetsThreadCommentModel).getSubUnitAll(this._workbook.getUnitId(),this._worksheet.getSheetId()).map(t=>this._injector.createInstance(exports.FThreadComment,t))}clearComments(){const o=this.getComments().map(t=>t.deleteAsync());return Promise.all(o).then(()=>!0)}onCommented(e){return this._injector.get(m.ICommandService).onCommandExecuted(t=>{if(t.id===a.AddCommentCommand.id){const n=t.params;e(n)}})}getCommentById(e){const t=this._injector.get(b.SheetsThreadCommentModel).getComment(this._workbook.getUnitId(),this._worksheet.getSheetId(),e);if(t)return this._injector.createInstance(exports.FThreadComment,t)}}f.FWorksheet.extend(F);const v={CommentAdded:"CommentAdded",BeforeCommentAdd:"BeforeCommentAdd",CommentUpdated:"CommentUpdated",BeforeCommentUpdate:"BeforeCommentUpdate",CommentDeleted:"CommentDeleted",BeforeCommentDeleted:"BeforeCommentDeleted",CommentResolved:"CommentResolved",BeforeCommentResolve:"BeforeCommentResolve"};class M extends S.FEventName{get CommentAdded(){return v.CommentAdded}get BeforeCommentAdd(){return v.BeforeCommentAdd}get CommentUpdated(){return v.CommentUpdated}get BeforeCommentUpdate(){return v.BeforeCommentUpdate}get CommentDeleted(){return v.CommentDeleted}get BeforeCommentDeleted(){return v.BeforeCommentDeleted}get CommentResolved(){return v.CommentResolved}get BeforeCommentResolve(){return v.BeforeCommentResolve}}S.FEventName.extend(M);class P extends S.FUniver{_initialize(e){const o=e.get(m.ICommandService);this.registerEventHandler(this.Event.CommentAdded,()=>o.onCommandExecuted(t=>{var d,h,C,g,l;if(t.id!==a.AddCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(d=this.getActiveWorkbook)==null?void 0:d.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{comment:u}=c,i=s.getRange(u.ref).getComment();i&&this.fireEvent(this.Event.CommentAdded,{workbook:r,worksheet:s,row:(C=(h=i.getRange())==null?void 0:h.getRow())!=null?C:0,col:(l=(g=i.getRange())==null?void 0:g.getColumn())!=null?l:0,comment:i})})),this.registerEventHandler(this.Event.CommentUpdated,()=>o.onCommandExecuted(t=>{var d,h,C,g,l;if(t.id!==a.UpdateCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(d=this.getActiveWorkbook)==null?void 0:d.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u}=c.payload,i=s.getCommentById(u);i&&this.fireEvent(this.Event.CommentUpdated,{workbook:r,worksheet:s,row:(C=(h=i.getRange())==null?void 0:h.getRow())!=null?C:0,col:(l=(g=i.getRange())==null?void 0:g.getColumn())!=null?l:0,comment:i})})),this.registerEventHandler(this.Event.CommentDeleted,()=>o.onCommandExecuted(t=>{var i;if(t.id!==a.DeleteCommentCommand.id&&t.id!==a.DeleteCommentTreeCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(i=this.getActiveWorkbook)==null?void 0:i.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u}=c;this.fireEvent(this.Event.CommentDeleted,{workbook:r,worksheet:s,commentId:u})})),this.registerEventHandler(this.Event.CommentResolved,()=>o.onCommandExecuted(t=>{var h,C,g;if(t.id!==a.ResolveCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(h=this.getActiveWorkbook)==null?void 0:h.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u,resolved:i}=c,d=s.getComments().find(l=>l.getCommentData().id===u);d&&this.fireEvent(this.Event.CommentResolved,{workbook:r,worksheet:s,row:(C=d.getRange().getRow())!=null?C:0,col:(g=d.getRange().getColumn())!=null?g:0,comment:d,resolved:i})})),this.registerEventHandler(this.Event.BeforeCommentAdd,()=>o.beforeCommandExecuted(t=>{var h,C,g;if(t.id!==a.AddCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(h=this.getActiveWorkbook)==null?void 0:h.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{comment:u}=c,i=s.getActiveRange();if(!i)return;const d={workbook:r,worksheet:s,row:(C=i.getRow())!=null?C:0,col:(g=i.getColumn())!=null?g:0,comment:U.create(u)};if(this.fireEvent(this.Event.BeforeCommentAdd,d),d.cancel)throw new m.CanceledError})),this.registerEventHandler(this.Event.BeforeCommentUpdate,()=>o.beforeCommandExecuted(t=>{var h,C,g,l,_;if(t.id!==a.UpdateCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(h=this.getActiveWorkbook)==null?void 0:h.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u,text:i}=c.payload,d=s.getCommentById(u);if(d){const w={workbook:r,worksheet:s,row:(g=(C=d.getRange())==null?void 0:C.getRow())!=null?g:0,col:(_=(l=d.getRange())==null?void 0:l.getColumn())!=null?_:0,comment:d,newContent:m.RichTextValue.createByBody(i)};if(this.fireEvent(this.Event.BeforeCommentUpdate,w),w.cancel)throw new m.CanceledError}})),this.registerEventHandler(this.Event.BeforeCommentDeleted,()=>o.beforeCommandExecuted(t=>{var d,h,C,g,l;if(t.id!==a.DeleteCommentCommand.id&&t.id!==a.DeleteCommentTreeCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(d=this.getActiveWorkbook)==null?void 0:d.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u}=c,i=s.getCommentById(u);if(i){const _={workbook:r,worksheet:s,row:(C=(h=i.getRange())==null?void 0:h.getRow())!=null?C:0,col:(l=(g=i.getRange())==null?void 0:g.getColumn())!=null?l:0,comment:i};if(this.fireEvent(this.Event.BeforeCommentDeleted,_),_.cancel)throw new m.CanceledError}})),this.registerEventHandler(this.Event.BeforeCommentResolve,()=>o.beforeCommandExecuted(t=>{var h,C,g;if(t.id!==a.ResolveCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(h=this.getActiveWorkbook)==null?void 0:h.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u,resolved:i}=c,d=s.getComments().find(l=>l.getCommentData().id===u);if(d){const l={workbook:r,worksheet:s,row:(C=d.getRange().getRow())!=null?C:0,col:(g=d.getRange().getColumn())!=null?g:0,comment:d,resolved:i};if(this.fireEvent(this.Event.BeforeCommentResolve,l),l.cancel)throw new m.CanceledError}}))}newTheadComment(e){return new k(e)}}S.FUniver.extend(P);
+"use strict";var T=Object.defineProperty;var E=(I,e,o)=>e in I?T(I,e,{enumerable:!0,configurable:!0,writable:!0,value:o}):I[e]=o;var R=(I,e,o)=>E(I,typeof e!="symbol"?e+"":e,o);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("@univerjs/core"),b=require("@univerjs/sheets-thread-comment"),f=require("@univerjs/sheets/facade"),a=require("@univerjs/thread-comment"),x=require("@univerjs/engine-formula"),y=require("rxjs"),S=require("@univerjs/core/facade");var A=Object.getOwnPropertyDescriptor,B=(I,e,o,t)=>{for(var n=t>1?void 0:t?A(e,o):e,r=I.length-1,s;r>=0;r--)(s=I[r])&&(n=s(n)||n);return n},p=(I,e)=>(o,t)=>e(o,t,I);class U{constructor(e){R(this,"_comment",{id:m.generateRandomId(),ref:"",threadId:"",dT:"",personId:"",text:m.RichTextBuilder.newEmptyData().body,attachments:[],unitId:"",subUnitId:""});e&&(this._comment=e)}static create(e){return new U(e)}get personId(){return this._comment.personId}get dateTime(){return this._comment.dT}get content(){return m.RichTextValue.createByBody(this._comment.text)}get id(){return this._comment.id}get threadId(){return this._comment.threadId}copy(){return k.create(m.Tools.deepClone(this._comment))}}class k extends U{static create(e){return new k(e)}setContent(e){return e instanceof m.RichTextValue?this._comment.text=e.getData().body:this._comment.text=e,this}setPersonId(e){return this._comment.personId=e,this}setDateTime(e){return this._comment.dT=a.getDT(e),this}setId(e){return this._comment.id=e,this}setThreadId(e){return this._comment.threadId=e,this}build(){return this._comment}}exports.FThreadComment=class{constructor(e,o,t,n,r,s,c){this._thread=e,this._parent=o,this._injector=t,this._commandService=n,this._univerInstanceService=r,this._threadCommentModel=s,this._userManagerService=c}_getRef(){var t;const e=((t=this._parent)==null?void 0:t.ref)||this._thread.ref;return x.deserializeRangeWithSheet(e).range}getIsRoot(){return!this._parent}getCommentData(){const{children:e,...o}=this._thread;return o}getReplies(){var t;const e=this._getRef(),o=this._threadCommentModel.getCommentWithChildren(this._thread.unitId,this._thread.subUnitId,e.startRow,e.startColumn);return(t=o==null?void 0:o.children)==null?void 0:t.map(n=>this._injector.createInstance(exports.FThreadComment,n))}getRange(){const e=this._univerInstanceService.getUnit(this._thread.unitId,m.UniverInstanceType.UNIVER_SHEET);if(!e)return null;const o=e.getSheetBySheetId(this._thread.subUnitId);if(!o)return null;const t=this._getRef();return this._injector.createInstance(f.FRange,e,o,t)}getContent(){return this._thread.text}getRichText(){const e=this._thread.text;return m.RichTextValue.create({body:e,documentStyle:{},id:"d"})}deleteAsync(){return this._commandService.executeCommand(this.getIsRoot()?a.DeleteCommentTreeCommand.id:a.DeleteCommentCommand.id,{commentId:this._thread.id,unitId:this._thread.unitId,subUnitId:this._thread.subUnitId})}delete(){return this.deleteAsync()}async update(e){return this.updateAsync(e)}async updateAsync(e){const o=e instanceof m.RichTextValue?e.getData().body:e,t=a.getDT();return await this._commandService.executeCommand(a.UpdateCommentCommand.id,{unitId:this._thread.unitId,subUnitId:this._thread.subUnitId,payload:{commentId:this._thread.id,text:o,updated:!0,updateT:t}})}resolve(e){return this.resolveAsync(e)}resolveAsync(e){return this._commandService.executeCommand(a.ResolveCommentCommand.id,{unitId:this._thread.unitId,subUnitId:this._thread.subUnitId,commentId:this._thread.id,resolved:e!=null?e:!this._thread.resolved})}replyAsync(e){var t;const o=e.build();return this._commandService.executeCommand(a.AddCommentCommand.id,{unitId:this._thread.unitId,subUnitId:this._thread.subUnitId,comment:{id:m.generateRandomId(),parentId:this._thread.id,threadId:this._thread.threadId,ref:((t=this._parent)==null?void 0:t.ref)||this._thread.ref,unitId:this._thread.unitId,subUnitId:this._thread.subUnitId,text:o.text,attachments:o.attachments,dT:o.dT||a.getDT(),personId:o.personId||this._userManagerService.getCurrentUser().userID}})}};exports.FThreadComment=B([p(2,m.Inject(m.Injector)),p(3,m.ICommandService),p(4,m.IUniverInstanceService),p(5,m.Inject(b.SheetsThreadCommentModel)),p(6,m.Inject(m.UserManagerService))],exports.FThreadComment);class D extends f.FRange{getComment(){const o=this._injector.get(b.SheetsThreadCommentModel),t=this._workbook.getUnitId(),n=this._worksheet.getSheetId(),r=o.getByLocation(t,n,this._range.startRow,this._range.startColumn);if(!r)return null;const s=o.getComment(t,n,r);return s?this._injector.createInstance(exports.FThreadComment,s):null}getComments(){const o=this._injector.get(b.SheetsThreadCommentModel),t=this._workbook.getUnitId(),n=this._worksheet.getSheetId(),r=[];return m.Range.foreach(this._range,(s,c)=>{const u=o.getByLocation(t,n,s,c);if(u){const i=o.getComment(t,n,u);i&&r.push(this._injector.createInstance(exports.FThreadComment,i))}}),r}addComment(e){var h;const o=this._injector,t=(h=this.getComment())==null?void 0:h.getCommentData(),n=o.get(m.ICommandService),r=o.get(m.UserManagerService),s=this._workbook.getUnitId(),c=this._worksheet.getSheetId(),u=`${m.Tools.chatAtABC(this._range.startColumn)}${this._range.startRow+1}`,i=r.getCurrentUser(),d=e instanceof k?e.build():{text:e};return n.executeCommand(a.AddCommentCommand.id,{unitId:s,subUnitId:c,comment:{text:d.text,dT:d.dT||a.getDT(),attachments:[],id:d.id||m.generateRandomId(),ref:u,personId:d.personId||i.userID,parentId:t==null?void 0:t.id,unitId:s,subUnitId:c,threadId:(t==null?void 0:t.threadId)||m.generateRandomId()}})}clearComment(){var s;const e=this._injector,o=(s=this.getComment())==null?void 0:s.getCommentData(),t=e.get(m.ICommandService),n=this._workbook.getUnitId(),r=this._worksheet.getSheetId();return o?t.executeCommand(a.DeleteCommentTreeCommand.id,{unitId:n,subUnitId:r,threadId:o.threadId,commentId:o.id}):Promise.resolve(!0)}clearComments(){const o=this.getComments().map(t=>t.deleteAsync());return Promise.all(o).then(()=>!0)}addCommentAsync(e){return this.addComment(e)}clearCommentAsync(){return this.clearComment()}clearCommentsAsync(){return this.clearComments()}}f.FRange.extend(D);class j extends f.FWorkbook{_initialize(){Object.defineProperty(this,"_threadCommentModel",{get(){return this._injector.get(a.ThreadCommentModel)}})}getComments(){return this._threadCommentModel.getUnit(this._workbook.getUnitId()).map(e=>this._injector.createInstance(exports.FThreadComment,e.root))}clearComments(){const o=this.getComments().map(t=>t.deleteAsync());return Promise.all(o).then(()=>!0)}onThreadCommentChange(e){return m.toDisposable(this._threadCommentModel.commentUpdate$.pipe(y.filter(o=>o.unitId===this._workbook.getUnitId())).subscribe(e))}onBeforeAddThreadComment(e){return m.toDisposable(this._commandService.beforeCommandExecuted((o,t)=>{const n=o.params;if(o.id===a.AddCommentCommand.id){if(n.unitId!==this._workbook.getUnitId())return;if(e(n,t)===!1)throw new Error("Command is stopped by the hook onBeforeAddThreadComment")}}))}onBeforeUpdateThreadComment(e){return m.toDisposable(this._commandService.beforeCommandExecuted((o,t)=>{const n=o.params;if(o.id===a.UpdateCommentCommand.id){if(n.unitId!==this._workbook.getUnitId())return;if(e(n,t)===!1)throw new Error("Command is stopped by the hook onBeforeUpdateThreadComment")}}))}onBeforeDeleteThreadComment(e){return m.toDisposable(this._commandService.beforeCommandExecuted((o,t)=>{const n=o.params;if(o.id===a.DeleteCommentCommand.id||o.id===a.DeleteCommentTreeCommand.id){if(n.unitId!==this._workbook.getUnitId())return;if(e(n,t)===!1)throw new Error("Command is stopped by the hook onBeforeDeleteThreadComment")}}))}}f.FWorkbook.extend(j);class F extends f.FWorksheet{getComments(){return this._injector.get(b.SheetsThreadCommentModel).getSubUnitAll(this._workbook.getUnitId(),this._worksheet.getSheetId()).map(t=>this._injector.createInstance(exports.FThreadComment,t))}clearComments(){const o=this.getComments().map(t=>t.deleteAsync());return Promise.all(o).then(()=>!0)}onCommented(e){return this._injector.get(m.ICommandService).onCommandExecuted(t=>{if(t.id===a.AddCommentCommand.id){const n=t.params;e(n)}})}getCommentById(e){const t=this._injector.get(b.SheetsThreadCommentModel).getComment(this._workbook.getUnitId(),this._worksheet.getSheetId(),e);if(t)return this._injector.createInstance(exports.FThreadComment,t)}}f.FWorksheet.extend(F);const v={CommentAdded:"CommentAdded",BeforeCommentAdd:"BeforeCommentAdd",CommentUpdated:"CommentUpdated",BeforeCommentUpdate:"BeforeCommentUpdate",CommentDeleted:"CommentDeleted",BeforeCommentDelete:"BeforeCommentDelete",CommentResolved:"CommentResolved",BeforeCommentResolve:"BeforeCommentResolve"};class M extends S.FEventName{get CommentAdded(){return v.CommentAdded}get BeforeCommentAdd(){return v.BeforeCommentAdd}get CommentUpdated(){return v.CommentUpdated}get BeforeCommentUpdate(){return v.BeforeCommentUpdate}get CommentDeleted(){return v.CommentDeleted}get BeforeCommentDelete(){return v.BeforeCommentDelete}get CommentResolved(){return v.CommentResolved}get BeforeCommentResolve(){return v.BeforeCommentResolve}}S.FEventName.extend(M);class P extends S.FUniver{_initialize(e){const o=e.get(m.ICommandService);this.registerEventHandler(this.Event.CommentAdded,()=>o.onCommandExecuted(t=>{var d,h,C,g,l;if(t.id!==a.AddCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(d=this.getActiveWorkbook)==null?void 0:d.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{comment:u}=c,i=s.getRange(u.ref).getComment();i&&this.fireEvent(this.Event.CommentAdded,{workbook:r,worksheet:s,row:(C=(h=i.getRange())==null?void 0:h.getRow())!=null?C:0,col:(l=(g=i.getRange())==null?void 0:g.getColumn())!=null?l:0,comment:i})})),this.registerEventHandler(this.Event.CommentUpdated,()=>o.onCommandExecuted(t=>{var d,h,C,g,l;if(t.id!==a.UpdateCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(d=this.getActiveWorkbook)==null?void 0:d.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u}=c.payload,i=s.getCommentById(u);i&&this.fireEvent(this.Event.CommentUpdated,{workbook:r,worksheet:s,row:(C=(h=i.getRange())==null?void 0:h.getRow())!=null?C:0,col:(l=(g=i.getRange())==null?void 0:g.getColumn())!=null?l:0,comment:i})})),this.registerEventHandler(this.Event.CommentDeleted,()=>o.onCommandExecuted(t=>{var i;if(t.id!==a.DeleteCommentCommand.id&&t.id!==a.DeleteCommentTreeCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(i=this.getActiveWorkbook)==null?void 0:i.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u}=c;this.fireEvent(this.Event.CommentDeleted,{workbook:r,worksheet:s,commentId:u})})),this.registerEventHandler(this.Event.CommentResolved,()=>o.onCommandExecuted(t=>{var h,C,g;if(t.id!==a.ResolveCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(h=this.getActiveWorkbook)==null?void 0:h.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u,resolved:i}=c,d=s.getComments().find(l=>l.getCommentData().id===u);d&&this.fireEvent(this.Event.CommentResolved,{workbook:r,worksheet:s,row:(C=d.getRange().getRow())!=null?C:0,col:(g=d.getRange().getColumn())!=null?g:0,comment:d,resolved:i})})),this.registerEventHandler(this.Event.BeforeCommentAdd,()=>o.beforeCommandExecuted(t=>{var h,C,g;if(t.id!==a.AddCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(h=this.getActiveWorkbook)==null?void 0:h.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{comment:u}=c,i=s.getActiveRange();if(!i)return;const d={workbook:r,worksheet:s,row:(C=i.getRow())!=null?C:0,col:(g=i.getColumn())!=null?g:0,comment:U.create(u)};if(this.fireEvent(this.Event.BeforeCommentAdd,d),d.cancel)throw new m.CanceledError})),this.registerEventHandler(this.Event.BeforeCommentUpdate,()=>o.beforeCommandExecuted(t=>{var h,C,g,l,_;if(t.id!==a.UpdateCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(h=this.getActiveWorkbook)==null?void 0:h.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u,text:i}=c.payload,d=s.getCommentById(u);if(d){const w={workbook:r,worksheet:s,row:(g=(C=d.getRange())==null?void 0:C.getRow())!=null?g:0,col:(_=(l=d.getRange())==null?void 0:l.getColumn())!=null?_:0,comment:d,newContent:m.RichTextValue.createByBody(i)};if(this.fireEvent(this.Event.BeforeCommentUpdate,w),w.cancel)throw new m.CanceledError}})),this.registerEventHandler(this.Event.BeforeCommentDelete,()=>o.beforeCommandExecuted(t=>{var d,h,C,g,l;if(t.id!==a.DeleteCommentCommand.id&&t.id!==a.DeleteCommentTreeCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(d=this.getActiveWorkbook)==null?void 0:d.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u}=c,i=s.getCommentById(u);if(i){const _={workbook:r,worksheet:s,row:(C=(h=i.getRange())==null?void 0:h.getRow())!=null?C:0,col:(l=(g=i.getRange())==null?void 0:g.getColumn())!=null?l:0,comment:i};if(this.fireEvent(this.Event.BeforeCommentDelete,_),_.cancel)throw new m.CanceledError}})),this.registerEventHandler(this.Event.BeforeCommentResolve,()=>o.beforeCommandExecuted(t=>{var h,C,g;if(t.id!==a.ResolveCommentCommand.id)return;const n=t.params;if(!n)return;const r=n.unitId?this.getUniverSheet(n.unitId):(h=this.getActiveWorkbook)==null?void 0:h.call(this);if(!r)return;const s=r.getSheetBySheetId(n.subUnitId||n.sheetId)||r.getActiveSheet();if(!s)return;const c=t.params,{commentId:u,resolved:i}=c,d=s.getComments().find(l=>l.getCommentData().id===u);if(d){const l={workbook:r,worksheet:s,row:(C=d.getRange().getRow())!=null?C:0,col:(g=d.getRange().getColumn())!=null?g:0,comment:d,resolved:i};if(this.fireEvent(this.Event.BeforeCommentResolve,l),l.cancel)throw new m.CanceledError}}))}newTheadComment(e){return new k(e)}}S.FUniver.extend(P);

package/lib/es/facade.js

@@ -1,7 +1,7 @@
 var L = Object.defineProperty;
 var N = (i, e, r) => e in i ? L(i, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : i[e] = r;
 var M = (i, e, r) => N(i, typeof e != "symbol" ? e + "" : e, r);
-import { Inject as T, Injector as V, ICommandService as _, IUniverInstanceService as q, UserManagerService as W, UniverInstanceType as G, RichTextValue as k, generateRandomId as R, RichTextBuilder as J, Tools as F, Range as K, toDisposable as S, CanceledError as E } from "@univerjs/core";
+import { Inject as T, Injector as V, ICommandService as p, IUniverInstanceService as q, UserManagerService as W, UniverInstanceType as G, RichTextValue as k, generateRandomId as R, RichTextBuilder as J, Tools as F, Range as K, toDisposable as S, CanceledError as E } from "@univerjs/core";
 import { SheetsThreadCommentModel as b } from "@univerjs/sheets-thread-comment";
 import { FRange as j, FWorkbook as H, FWorksheet as O } from "@univerjs/sheets/facade";
 import { DeleteCommentTreeCommand as w, DeleteCommentCommand as y, getDT as B, UpdateCommentCommand as x, ResolveCommentCommand as D, AddCommentCommand as f, ThreadCommentModel as Q } from "@univerjs/thread-comment";
@@ -12,7 +12,7 @@ var Z = Object.getOwnPropertyDescriptor, ee = (i, e, r, t) => {
   for (var n = t > 1 ? void 0 : t ? Z(e, r) : e, o = i.length - 1, s; o >= 0; o--)
     (s = i[o]) && (n = s(n) || n);
   return n;
-}, p = (i, e) => (r, t) => e(r, t, i);
+}, _ = (i, e) => (r, t) => e(r, t, i);
 class A {
   constructor(e) {
     M(this, "_comment", {
@@ -34,7 +34,8 @@ class A {
    * @returns {FTheadCommentItem} A new instance of FTheadCommentItem
    * @example
    * ```ts
-   * const comment = univerAPI.newTheadComment();
+   * const commentBuilder = univerAPI.newTheadComment();
+   * console.log(commentBuilder);
    * ```
    */
   static create(e) {
@@ -45,10 +46,8 @@ class A {
    * @returns {string} The person id of the comment
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const personId = comment.personId;
+   * const commentBuilder = univerAPI.newTheadComment();
+   * console.log(commentBuilder.personId);
    * ```
    */
   get personId() {
@@ -59,10 +58,8 @@ class A {
    * @returns {string} The date time of the comment
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const dateTime = comment.dateTime;
+   * const commentBuilder = univerAPI.newTheadComment();
+   * console.log(commentBuilder.dateTime);
    * ```
    */
   get dateTime() {
@@ -73,10 +70,8 @@ class A {
    * @returns {RichTextValue} The content of the comment
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const content = comment.content;
+   * const commentBuilder = univerAPI.newTheadComment();
+   * console.log(commentBuilder.content);
    * ```
    */
   get content() {
@@ -87,10 +82,8 @@ class A {
    * @returns {string} The id of the comment
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const id = comment.id;
+   * const commentBuilder = univerAPI.newTheadComment();
+   * console.log(commentBuilder.id);
    * ```
    */
   get id() {
@@ -101,10 +94,8 @@ class A {
    * @returns {string} The thread id of the comment
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const threadId = comment.threadId;
+   * const commentBuilder = univerAPI.newTheadComment();
+   * console.log(commentBuilder.threadId);
    * ```
    */
   get threadId() {
@@ -115,10 +106,9 @@ class A {
    * @returns {FTheadCommentBuilder} The comment builder
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const newComment = comment.copy();
+   * const commentBuilder = univerAPI.newTheadComment();
+   * const newCommentBuilder = commentBuilder.copy();
+   * console.log(newCommentBuilder);
    * ```
    */
   copy() {
@@ -132,11 +122,21 @@ class U extends A {
   /**
    * Set the content of the comment
    * @param {IDocumentBody | RichTextValue} content The content of the comment
-   * @returns {FTheadCommentBuilder} The comment builder
+   * @returns {FTheadCommentBuilder} The comment builder for chaining
    * @example
    * ```ts
-   * const comment = univerAPI.newTheadComment()
-   *   .setContent(univerAPI.newRichText().insertText('hello zhangsan'));
+   * // Create a new comment
+   * const richText = univerAPI.newRichText().insertText('hello univer');
+   * const commentBuilder = univerAPI.newTheadComment()
+   *   .setContent(richText);
+   * console.log(commentBuilder.content);
+   *
+   * // Add the comment to the cell A1
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const cell = fWorksheet.getRange('A1');
+   * const result = await cell.addCommentAsync(commentBuilder);
+   * console.log(result);
    * ```
    */
   setContent(e) {
@@ -145,11 +145,22 @@ class U extends A {
   /**
    * Set the person id of the comment
    * @param {string} userId The person id of the comment
-   * @returns {FTheadCommentBuilder} The comment builder
+   * @returns {FTheadCommentBuilder} The comment builder for chaining
    * @example
    * ```ts
-   * const comment = univerAPI.newTheadComment()
-   *   .setPersonId('123');
+   * // Create a new comment
+   * const richText = univerAPI.newRichText().insertText('hello univer');
+   * const commentBuilder = univerAPI.newTheadComment()
+   *   .setContent(richText)
+   *   .setPersonId('mock-user-id');
+   * console.log(commentBuilder.personId);
+   *
+   * // Add the comment to the cell A1
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const cell = fWorksheet.getRange('A1');
+   * const result = await cell.addCommentAsync(commentBuilder);
+   * console.log(result);
    * ```
    */
   setPersonId(e) {
@@ -158,11 +169,22 @@ class U extends A {
   /**
    * Set the date time of the comment
    * @param {Date} date The date time of the comment
-   * @returns {FTheadCommentBuilder} The comment builder
+   * @returns {FTheadCommentBuilder} The comment builder for chaining
    * @example
    * ```ts
-   * const comment = univerAPI.newTheadComment()
-   *   .setDateTime(new Date());
+   * // Create a new comment
+   * const richText = univerAPI.newRichText().insertText('hello univer');
+   * const commentBuilder = univerAPI.newTheadComment()
+   *   .setContent(richText)
+   *   .setDateTime(new Date('2025-02-21 14:22:22'));
+   * console.log(commentBuilder.dateTime);
+   *
+   * // Add the comment to the cell A1
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const cell = fWorksheet.getRange('A1');
+   * const result = await cell.addCommentAsync(commentBuilder);
+   * console.log(result);
    * ```
    */
   setDateTime(e) {
@@ -171,11 +193,22 @@ class U extends A {
   /**
    * Set the id of the comment
    * @param {string} id The id of the comment
-   * @returns {FTheadCommentBuilder} The comment builder
+   * @returns {FTheadCommentBuilder} The comment builder for chaining
    * @example
    * ```ts
-   * const comment = univerAPI.newTheadComment()
-   *   .setId('123');
+   * // Create a new comment
+   * const richText = univerAPI.newRichText().insertText('hello univer');
+   * const commentBuilder = univerAPI.newTheadComment()
+   *   .setContent(richText)
+   *   .setId('mock-comment-id');
+   * console.log(commentBuilder.id);
+   *
+   * // Add the comment to the cell A1
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const cell = fWorksheet.getRange('A1');
+   * const result = await cell.addCommentAsync(commentBuilder);
+   * console.log(result);
    * ```
    */
   setId(e) {
@@ -187,8 +220,19 @@ class U extends A {
    * @returns {FTheadCommentBuilder} The comment builder
    * @example
    * ```ts
-   * const comment = univerAPI.newTheadComment()
-   *   .setThreadId('123');
+   * // Create a new comment
+   * const richText = univerAPI.newRichText().insertText('hello univer');
+   * const commentBuilder = univerAPI.newTheadComment()
+   *   .setContent(richText)
+   *   .setThreadId('mock-thread-id');
+   * console.log(commentBuilder.threadId);
+   *
+   * // Add the comment to the cell A1
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const cell = fWorksheet.getRange('A1');
+   * const result = await cell.addCommentAsync(commentBuilder);
+   * console.log(result);
    * ```
    */
   setThreadId(e) {
@@ -199,9 +243,15 @@ class U extends A {
    * @returns {IThreadComment} The comment
    * @example
    * ```ts
+   * const richText = univerAPI.newRichText().insertText('hello univer');
    * const comment = univerAPI.newTheadComment()
-   *   .setContent(univerAPI.newRichText().insertText('hello zhangsan'))
+   *   .setContent(richText)
+   *   .setPersonId('mock-user-id')
+   *   .setDateTime(new Date('2025-02-21 14:22:22'))
+   *   .setId('mock-comment-id')
+   *   .setThreadId('mock-thread-id')
    *   .build();
+   * console.log(comment);
    * ```
    */
   build() {
@@ -225,10 +275,12 @@ let I = class {
    * @returns {boolean} Whether the comment is a root comment
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const isRoot = comment.getIsRoot();
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const comments = fWorksheet.getComments();
+   * comments.forEach((comment) => {
+   *   console.log(comment.getIsRoot());
+   * });
    * ```
    */
   getIsRoot() {
@@ -239,10 +291,12 @@ let I = class {
    * @returns {IBaseComment} The comment data
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const commentData = comment.getCommentData();
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const comments = fWorksheet.getComments();
+   * comments.forEach((comment) => {
+   *   console.log(comment.getCommentData());
+   * });
    * ```
    */
   getCommentData() {
@@ -254,10 +308,17 @@ let I = class {
    * @returns {FThreadComment[]} the replies of the comment
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const replies = comment.getReplies();
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const comments = fWorksheet.getComments();
+   * comments.forEach((comment) => {
+   *   if (comment.getIsRoot()) {
+   *     const replies = comment.getReplies();
+   *     replies.forEach((reply) => {
+   *       console.log(reply.getCommentData());
+   *     });
+   *   }
+   * });
    * ```
    */
   getReplies() {
@@ -270,10 +331,12 @@ let I = class {
    * @returns {FRange | null} The range of the comment
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const range = comment.getRange();
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const comments = fWorksheet.getComments();
+   * comments.forEach((comment) => {
+   *   console.log(comment.getRange().getA1Notation());
+   * });
    * ```
    */
   getRange() {
@@ -298,10 +361,12 @@ let I = class {
    * @returns {RichTextValue} The rich text of the comment
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const richText = comment.getRichText();
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const comments = fWorksheet.getComments();
+   * comments.forEach((comment) => {
+   *   console.log(comment.getRichText());
+   * });
    * ```
    */
   getRichText() {
@@ -310,13 +375,16 @@ let I = class {
   }
   /**
    * Delete the comment and it's replies
-   * @returns {Promise<boolean>} success or not
+   * @returns {Promise<boolean>} Whether the comment is deleted successfully
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const success = await comment.deleteAsync();
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   * const comments = fWorksheet.getComments();
+   *
+   * // Delete the first comment
+   * const result = await comments[0]?.deleteAsync();
+   * console.log(result);
    * ```
    */
   deleteAsync() {
@@ -346,13 +414,27 @@ let I = class {
   /**
    * Update the comment content
    * @param {IDocumentBody | RichTextValue} content The new content of the comment
-   * @returns {Promise<boolean>} success or not
+   * @returns {Promise<boolean>} Whether the comment is updated successfully
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const success = await comment.updateAsync(univerAPI.newRichText().insertText('hello zhangsan'));
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   *
+   * // Create a new comment
+   * const richText = univerAPI.newRichText().insertText('hello univer');
+   * const commentBuilder = univerAPI.newTheadComment()
+   *   .setContent(richText)
+   *   .setId('mock-comment-id');
+   * const cell = fWorksheet.getRange('A1');
+   * await cell.addCommentAsync(commentBuilder);
+   *
+   * // Update the comment after 3 seconds
+   * setTimeout(async () => {
+   *   const comment = fWorksheet.getCommentById('mock-comment-id');
+   *   const newRichText = univerAPI.newRichText().insertText('Hello Univer AI');
+   *   const result = await comment.updateAsync(newRichText);
+   *   console.log(result);
+   * }, 3000);
    * ```
    */
   async updateAsync(i) {
@@ -381,13 +463,26 @@ let I = class {
   /**
    * Resolve the comment
    * @param {boolean} resolved Whether the comment is resolved
-   * @returns {Promise<boolean>} success or not
+   * @returns {Promise<boolean>} Set the comment to resolved or not operation result
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
-   * const success = await comment.resolveAsync(true);
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
+   *
+   * // Create a new comment
+   * const richText = univerAPI.newRichText().insertText('hello univer');
+   * const commentBuilder = univerAPI.newTheadComment()
+   *   .setContent(richText)
+   *   .setId('mock-comment-id');
+   * const cell = fWorksheet.getRange('A1');
+   * await cell.addCommentAsync(commentBuilder);
+   *
+   * // Resolve the comment after 3 seconds
+   * setTimeout(async () => {
+   *   const comment = fWorksheet.getCommentById('mock-comment-id');
+   *   const result = await comment.resolveAsync(true);
+   *   console.log(result);
+   * }, 3000);
    * ```
    */
   resolveAsync(i) {
@@ -404,20 +499,29 @@ let I = class {
   /**
    * Reply to the comment
    * @param {FTheadCommentBuilder} comment The comment to reply to
-   * @returns {Promise<boolean>} success or not
+   * @returns {Promise<boolean>} Whether the comment is replied successfully
    * @example
    * ```ts
-   * const comment = univerAPI.getActiveWorkbook()
-   *   .getSheetById(sheetId)
-   *   .getCommentById(commentId);
+   * const fWorkbook = univerAPI.getActiveWorkbook();
+   * const fWorksheet = fWorkbook.getActiveSheet();
    *
-   * const reply = univerAPI.newTheadComment()
-   *   .setContent(univerAPI.newRichText().insertText('hello zhangsan'));
+   * // Create a new comment
+   * const richText = univerAPI.newRichText().insertText('hello univer');
+   * const commentBuilder = univerAPI.newTheadComment()
+   *   .setContent(richText)
+   *   .setId('mock-comment-id');
+   * const cell = fWorksheet.getRange('A1');
+   * await cell.addCommentAsync(commentBuilder);
    *
-   * const success = await comment.replyAsync(reply);
+   * // Reply to the comment
+   * const replyText = univerAPI.newRichText().insertText('Hello Univer AI');
+   * const reply = univerAPI.newTheadComment().setContent(replyText);
+   * const comment = fWorksheet.getCommentById('mock-comment-id');
+   * const result = await comment.replyAsync(reply);
+   * console.log(result);
    * ```
    */
-  async replyAsync(i) {
+  replyAsync(i) {
     var r;
     const e = i.build();
     return this._commandService.executeCommand(
@@ -429,7 +533,7 @@ let I = class {
           id: R(),
           parentId: this._thread.id,
           threadId: this._thread.threadId,
-          ref: (r = this._parent) == null ? void 0 : r.ref,
+          ref: ((r = this._parent) == null ? void 0 : r.ref) || this._thread.ref,
           unitId: this._thread.unitId,
           subUnitId: this._thread.subUnitId,
           text: e.text,
@@ -442,11 +546,11 @@ let I = class {
   }
 };
 I = ee([
-  p(2, T(V)),
-  p(3, _),
-  p(4, q),
-  p(5, T(b)),
-  p(6, T(W))
+  _(2, T(V)),
+  _(3, p),
+  _(4, q),
+  _(5, T(b)),
+  _(6, T(W))
 ], I);
 class te extends j {
   getComment() {
@@ -468,7 +572,7 @@ class te extends j {
   }
   addComment(e) {
     var a;
-    const r = this._injector, t = (a = this.getComment()) == null ? void 0 : a.getCommentData(), n = r.get(_), o = r.get(W), s = this._workbook.getUnitId(), h = this._worksheet.getSheetId(), c = `${F.chatAtABC(this._range.startColumn)}${this._range.startRow + 1}`, m = o.getCurrentUser(), d = e instanceof U ? e.build() : { text: e };
+    const r = this._injector, t = (a = this.getComment()) == null ? void 0 : a.getCommentData(), n = r.get(p), o = r.get(W), s = this._workbook.getUnitId(), h = this._worksheet.getSheetId(), c = `${F.chatAtABC(this._range.startColumn)}${this._range.startRow + 1}`, m = o.getCurrentUser(), d = e instanceof U ? e.build() : { text: e };
     return n.executeCommand(f.id, {
       unitId: s,
       subUnitId: h,
@@ -488,7 +592,7 @@ class te extends j {
   }
   clearComment() {
     var s;
-    const e = this._injector, r = (s = this.getComment()) == null ? void 0 : s.getCommentData(), t = e.get(_), n = this._workbook.getUnitId(), o = this._worksheet.getSheetId();
+    const e = this._injector, r = (s = this.getComment()) == null ? void 0 : s.getCommentData(), t = e.get(p), n = this._workbook.getUnitId(), o = this._worksheet.getSheetId();
     return r ? t.executeCommand(w.id, {
       unitId: n,
       subUnitId: o,
@@ -596,7 +700,7 @@ class re extends O {
    * @param callback Callback function, param contains comment info and target cell.
    */
   onCommented(e) {
-    return this._injector.get(_).onCommandExecuted((t) => {
+    return this._injector.get(p).onCommandExecuted((t) => {
       if (t.id === f.id) {
         const n = t.params;
         e(n);
@@ -616,7 +720,7 @@ const l = {
   CommentUpdated: "CommentUpdated",
   BeforeCommentUpdate: "BeforeCommentUpdate",
   CommentDeleted: "CommentDeleted",
-  BeforeCommentDeleted: "BeforeCommentDeleted",
+  BeforeCommentDelete: "BeforeCommentDelete",
   CommentResolved: "CommentResolved",
   BeforeCommentResolve: "BeforeCommentResolve"
 };
@@ -636,8 +740,8 @@ class oe extends z {
   get CommentDeleted() {
     return l.CommentDeleted;
   }
-  get BeforeCommentDeleted() {
-    return l.BeforeCommentDeleted;
+  get BeforeCommentDelete() {
+    return l.BeforeCommentDelete;
   }
   get CommentResolved() {
     return l.CommentResolved;
@@ -650,7 +754,7 @@ z.extend(oe);
 class se extends $ {
   // eslint-disable-next-line max-lines-per-function
   _initialize(e) {
-    const r = e.get(_);
+    const r = e.get(p);
     this.registerEventHandler(
       this.Event.CommentAdded,
       () => r.onCommandExecuted((t) => {
@@ -779,7 +883,7 @@ class se extends $ {
         }
       })
     ), this.registerEventHandler(
-      this.Event.BeforeCommentDeleted,
+      this.Event.BeforeCommentDelete,
       () => r.beforeCommandExecuted((t) => {
         var d, a, u, g, C;
         if (t.id !== y.id && t.id !== w.id) return;
@@ -798,7 +902,7 @@ class se extends $ {
             col: (C = (g = m.getRange()) == null ? void 0 : g.getColumn()) != null ? C : 0,
             comment: m
           };
-          if (this.fireEvent(this.Event.BeforeCommentDeleted, v), v.cancel)
+          if (this.fireEvent(this.Event.BeforeCommentDelete, v), v.cancel)
             throw new E();
         }
       })