oasis-editor 0.0.204 → 0.0.206

package/dist/core/commands/builtinCommands.d.ts

@@ -1,2 +1,2 @@
-export declare const OASIS_BUILTIN_COMMANDS: readonly ["selectAll", "insertFootnote", "insertText", "insertEquation", "updateEquation", "insertTableOfContents", "updateTableOfContents", "pastePlainText", "paste", "pasteAsPlainText", "pasteMergeFormatting", "formatPainter", "formatPainterContinuous", "cancelFormatPainter", "bold", "italic", "underline", "strike", "superscript", "subscript", "link", "unlink", "alignLeft", "alignCenter", "alignRight", "alignJustify", "orderedList", "bulletList", "find", "replace", "toggleTrackChanges", "acceptRevisions", "rejectRevisions", "nextRevision", "previousRevision", "nextComment", "previousComment", "newComment", "replyComment", "resolveComment", "reopenComment", "deleteComment", "toggleShowMargins", "toggleShowParagraphMarks", "togglePreciseFonts", "undo", "redo", "pageBreak", "lineBreak", "splitBlock", "setFontFamily", "setFontSize", "increaseFontSize", "decreaseFontSize", "changeTextCase", "clearFormatting", "setColor", "setHighlight", "setTextShading", "setStyleId", "setCharacterStyleId", "setUnderlineStyle", "documentStyles", "print", "copy", "cut", "newDocument", "exportDocx", "exportPdf", "importDocument", "insertHtml", "insertImage", "editImageAlt", "insertImageCaption", "imageContext", "imageWidthCm", "imageHeightCm", "imageCrop", "imageCropAspect", "imageCropShape", "imageCropFill", "imageCropFit", "imageCropReset", "imageBorder", "outdent", "indent", "togglePageBreakBefore", "toggleKeepWithNext", "setSpacingAfter", "setSpacingBefore", "setIndentLeft", "setIndentRight", "setIndentFirstLine", "setIndentHanging", "setSpecialIndent", "setParagraphShading", "applyParagraphBorders", "setLineHeight", "setListFormat", "setListStartAt", "toggleOrientation", "setOrientation", "sectionBreakNextPage", "sectionBreakContinuous", "setPageMargins", "applyDocumentTheme", "setDocumentColorScheme", "setDocumentFontScheme", "setDocumentParagraphSpacing", "setDocumentEffects", "setDocumentPageColor", "setDocumentWatermark", "setDocumentPageBorder", "setDocumentDesignDefault", "tableContext", "tableMerge", "tableSplit", "tableInsertColumnBefore", "tableInsertColumnAfter", "tableDeleteColumn", "tableInsertRowBefore", "tableInsertRowAfter", "tableDeleteRow", "tableCellShading", "tableCellBorders", "tableCellNoBorders", "tableApplyBorderPreset", "toggleTableDrawBorders", "toggleTableGridlines", "tableWidth100", "tableAlignLeft", "tableAlignCenter", "tableAlignRight", "tableSetCellWidth", "tableToggleHeaderRow", "tableToggleTotalRow", "tableToggleBandedRows", "tableToggleFirstColumn", "tableToggleLastColumn", "tableToggleBandedColumns", "setTableStyle", "tableToggleAutoFit", "tableDistributeColumns", "tableDistributeRows", "insertTable", "insertShape", "openSymbolDialog", "openEquationDialog"];
+export declare const OASIS_BUILTIN_COMMANDS: readonly ["selectAll", "insertFootnote", "insertText", "insertEquation", "updateEquation", "insertTableOfContents", "updateTableOfContents", "pastePlainText", "paste", "pasteAsPlainText", "pasteMergeFormatting", "formatPainter", "formatPainterContinuous", "cancelFormatPainter", "bold", "italic", "underline", "strike", "superscript", "subscript", "link", "unlink", "alignLeft", "alignCenter", "alignRight", "alignJustify", "orderedList", "bulletList", "find", "replace", "toggleTrackChanges", "acceptRevisions", "rejectRevisions", "nextRevision", "previousRevision", "nextComment", "previousComment", "newComment", "replyComment", "editComment", "toggleCommentsPanel", "resolveComment", "reopenComment", "deleteComment", "toggleShowMargins", "toggleShowParagraphMarks", "togglePreciseFonts", "undo", "redo", "pageBreak", "lineBreak", "splitBlock", "setFontFamily", "setFontSize", "increaseFontSize", "decreaseFontSize", "changeTextCase", "clearFormatting", "setColor", "setHighlight", "setTextShading", "setStyleId", "setCharacterStyleId", "setUnderlineStyle", "documentStyles", "print", "copy", "cut", "newDocument", "exportDocx", "exportPdf", "importDocument", "insertHtml", "insertImage", "editImageAlt", "insertImageCaption", "imageContext", "imageWidthCm", "imageHeightCm", "imageCrop", "imageCropAspect", "imageCropShape", "imageCropFill", "imageCropFit", "imageCropReset", "imageBorder", "outdent", "indent", "togglePageBreakBefore", "toggleKeepWithNext", "setSpacingAfter", "setSpacingBefore", "setIndentLeft", "setIndentRight", "setIndentFirstLine", "setIndentHanging", "setSpecialIndent", "setParagraphShading", "applyParagraphBorders", "setLineHeight", "setListFormat", "setListStartAt", "toggleOrientation", "setOrientation", "sectionBreakNextPage", "sectionBreakContinuous", "setPageMargins", "applyDocumentTheme", "setDocumentColorScheme", "setDocumentFontScheme", "setDocumentParagraphSpacing", "setDocumentEffects", "setDocumentPageColor", "setDocumentWatermark", "setDocumentPageBorder", "setDocumentDesignDefault", "tableContext", "tableMerge", "tableSplit", "tableInsertColumnBefore", "tableInsertColumnAfter", "tableDeleteColumn", "tableInsertRowBefore", "tableInsertRowAfter", "tableDeleteRow", "tableCellShading", "tableCellBorders", "tableCellNoBorders", "tableApplyBorderPreset", "toggleTableDrawBorders", "toggleTableGridlines", "tableWidth100", "tableAlignLeft", "tableAlignCenter", "tableAlignRight", "tableSetCellWidth", "tableToggleHeaderRow", "tableToggleTotalRow", "tableToggleBandedRows", "tableToggleFirstColumn", "tableToggleLastColumn", "tableToggleBandedColumns", "setTableStyle", "tableToggleAutoFit", "tableDistributeColumns", "tableDistributeRows", "insertTable", "insertShape", "openSymbolDialog", "openEquationDialog"];
 export type OasisBuiltinCommand = (typeof OASIS_BUILTIN_COMMANDS)[number];

package/dist/core/commands/commentAuthoring.d.ts

@@ -4,6 +4,7 @@ export interface CommentContent {
     author: string;
     text: string;
     date: number;
+    authorId?: string;
 }
 export interface CommentRange {
     start: EditorCommentAnchor;
@@ -21,3 +22,9 @@ export declare function insertCommentAtSelection(state: EditorState, content: Co
 export declare function replyToComment(state: EditorState, parentId: string, content: CommentContent): EditorState;
 /** Render a nested discussion in document insertion order without duplicating anchors. */
 export declare function collectCommentThreadReplies(comments: Readonly<Record<string, EditorComment>>, parentId: string): EditorComment[];
+/**
+ * Modify only the comment body. Keep its stable id, author, creation date,
+ * anchors, resolved flag and parent id for reliable DOCX round-tripping.
+ * A blank body or identical normalized value produces no transaction.
+ */
+export declare function editCommentText(state: EditorState, commentId: string, text: string): EditorState;

package/dist/core/commands/commentPermissions.d.ts

@@ -0,0 +1,17 @@
+import { EditorComment, EditorComments } from '../model.js';
+/** Policy data is owned by core; UI is a consumer, not a dependency. */
+export interface OasisReviewAccess {
+    identity?: {
+        id: string;
+        displayName: string;
+    };
+    canModerate?: boolean;
+}
+/**
+ * Standalone / not configured: legacy local editing remains permissive.
+ * Configured: only the trusted, stable host actor ID owns a comment.
+ * Imported DOCX author names are presentation data, never proof of identity.
+ */
+export declare function canEditReviewComment(access: OasisReviewAccess | undefined, comment: EditorComment | undefined): boolean;
+/** Deleting a thread also deletes its descendants, so verify every author. */
+export declare function canDeleteReviewThread(access: OasisReviewAccess | undefined, registry: EditorComments | undefined, id: string): boolean;

package/dist/core/commands/publicCommandTypes.d.ts

@@ -70,6 +70,8 @@ export interface OasisCommandPayloads {
     previousComment: undefined;
     newComment: undefined;
     replyComment: undefined;
+    editComment: undefined;
+    toggleCommentsPanel: undefined;
     resolveComment: undefined;
     reopenComment: undefined;
     deleteComment: undefined;

package/dist/core/commands/reviewNavigation.d.ts

@@ -16,11 +16,19 @@ export declare function navigateComment(state: EditorState, direction: "next" |
  * overlapping comment. Replies without anchors are managed by parent id.
  */
 export declare function getSelectedReviewComment(state: EditorState): EditorComment | null;
-/** Keep all comment metadata/anchors intact for DOCX round-trip. */
+/**
+ * Jump to an anchored comment in the active section/zone. A reply navigates
+ * to its closest anchored ancestor, without changing document text.
+ */
+export declare function focusReviewCommentById(state: EditorState, id: string): EditorState;
+export declare function setReviewCommentResolvedById(state: EditorState, id: string, resolved: boolean): EditorState;
+/** The selected-comment actions share the same immutable ID based mutations. */
 export declare function setSelectedCommentResolved(state: EditorState, resolved: boolean): EditorState;
 /**
- * Deleting a parent thread deletes all its descendants, preventing dangling
- * parentId pointers in commentsExtended.xml.
+ * Remove a discussion and all descendants; never leave orphaned parent ids.
+ * This pure model operation intentionally has no knowledge of authenticated
+ * users: the editor command host must check permissions before invoking it.
  */
+export declare function deleteReviewCommentById(state: EditorState, id: string): EditorState;
 export declare function deleteSelectedComment(state: EditorState): EditorState;
 export {};

package/dist/core/model/types/documentComments.d.ts

@@ -30,6 +30,11 @@ export interface EditorComment {
     docxIdHint?: number;
     /** `w:comment/@w:author`. */
     author: string;
+    /**
+     * Application-local stable author identity. DOCX stores only display names;
+     * this field is not silently reconstructed from a DOCX author on import.
+     */
+    authorId?: string;
     /** `w:comment/@w:initials`. */
     initials?: string;
     /** `w:comment/@w:date` as an epoch millisecond timestamp. */