oasis-editor 0.0.205 → 0.0.207

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", "editComment", "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;

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

@@ -71,6 +71,7 @@ export interface OasisCommandPayloads {
     newComment: undefined;
     replyComment: undefined;
     editComment: undefined;
+    toggleCommentsPanel: undefined;
     resolveComment: undefined;
     reopenComment: undefined;
     deleteComment: undefined;

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

@@ -0,0 +1,15 @@
+import { EditorReviewActivity, EditorReviewActivityKind, EditorState } from '../model.js';
+/** Only successful comment operations append a record; no UI-side logging. */
+export declare function appendReviewActivity(state: EditorState, activity: EditorReviewActivity): EditorState;
+/** Resolves thread identity safely for arbitrarily nested or cyclic replies. */
+export declare function getReviewThreadId(state: EditorState, commentId: string): string | null;
+/** Append in the same undoable transaction as the changed comment. */
+export declare function appendReviewChange(before: EditorState, after: EditorState, detail: {
+    id: string;
+    kind: EditorReviewActivityKind;
+    commentId: string;
+    actorName: string;
+    actorId?: string;
+    timestamp: number;
+    parentId?: string;
+}): EditorState;

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/editorState/nodeFactories.d.ts

@@ -1,5 +1,5 @@
 import { EditorBlockNode, EditorFootnote, EditorParagraphNode, EditorTableCellNode, EditorTableNode, EditorTableRowNode, EditorTextRun, EditorTextStyle, EditorTextBoxData, EditorImageRunData } from '../model.js';
-export type EditorNodeKind = "document" | "paragraph" | "run" | "table" | "table-row" | "table-cell" | "footnote" | "bookmark" | "comment" | "sdt";
+export type EditorNodeKind = "document" | "paragraph" | "run" | "table" | "table-row" | "table-cell" | "footnote" | "bookmark" | "comment" | "review-activity" | "sdt";
 /**
  * Single authority for editor node IDs. Stateless and globally unique, so two
  * editors mounted on the same page never share a sequence. The `kind` prefix is

package/dist/core/model/index.d.ts

@@ -17,6 +17,7 @@ export type { EditorFootnote } from './types/documentFootnotes.js';
 export type { EditorEndnote } from './types/documentEndnotes.js';
 export type { EditorBookmark, EditorBookmarkAnchor, EditorBookmarks, } from './types/documentBookmarks.js';
 export type { EditorComment, EditorCommentAnchor, EditorComments, } from './types/documentComments.js';
+export type { EditorReviewActivity, EditorReviewActivityKind, } from './types/documentReviewActivity.js';
 export type { EditorOpcPartKind, EditorOpcPartEncoding, EditorOpcRelationship, EditorOpcContentTypes, EditorOpcPart, EditorDocxDiagnostic, EditorDocxSourcePackage, } from './types/docxSourcePackage.js';
 export type { EditorPageMargins, EditorPageSettings, EditorColumnsSettings, EditorSection, EditorSectionBreakType, EditorSectionPropertiesSnapshot, EditorPageNumbering, EditorSectionVerticalAlign, EditorFontInfo, EditorFootnoteSettings, EditorFootnotes, EditorEndnoteSettings, EditorEndnotes, EditorDocumentDesign, EditorThemeData, EditorWatermark, EditorPageBorder, EditorDocument, } from './types/document.js';
 export type { EditorPosition, EditorSelection, EditorEditingZone, } from './types/selection.js';

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

@@ -4,6 +4,7 @@ import { EditorFootnote } from './documentFootnotes.js';
 import { EditorEndnote } from './documentEndnotes.js';
 import { EditorBookmarks } from './documentBookmarks.js';
 import { EditorComments } from './documentComments.js';
+import { EditorReviewActivity } from './documentReviewActivity.js';
 import { EditorNamedStyle } from './styles.js';
 import { EditorDocxSourcePackage } from './docxSourcePackage.js';
 export interface EditorPageMargins {
@@ -238,6 +239,11 @@ export interface EditorDocument {
      * body shown in a hover/click popup.
      */
     comments?: EditorComments;
+    /**
+     * Local review activity for the editor document. Not a DOCX comment part,
+     * authenticated server audit, or immutable event log. Part of undo/redo.
+     */
+    reviewActivity?: EditorReviewActivity[];
     /**
      * `word/fontTable.xml` entries: the fonts the document declares, with
      * substitution metadata. Preserved on import and re-emitted on 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. */

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

@@ -0,0 +1,22 @@
+/**
+ * Local review timeline entries, created on successful comment mutations.
+ * These are transaction-scoped editor data and are intentionally not emitted
+ * as WordprocessingML. The host can persist/export them separately if needed.
+ */
+export type EditorReviewActivityKind = "comment-created" | "comment-replied" | "comment-edited" | "comment-resolved" | "comment-reopened" | "comment-deleted";
+export interface EditorReviewActivity {
+    id: string;
+    kind: EditorReviewActivityKind;
+    commentId: string;
+    /** Immediate parent when a reply is created. */
+    parentId?: string;
+    /** Stable root discussion id, even if subsequently removed. */
+    threadId: string;
+    actorName: string;
+    actorId?: string;
+    /** Snapshot label survives deletion without copying the comment body. */
+    targetAuthor: string;
+    timestamp: number;
+    /** Number of comments deleted with the selected subtree. */
+    affectedCount?: number;
+}