oasis-editor 0.0.206 → 0.0.208

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

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ *
+ * The array is deliberately NOT capped: it rides snapshot-based undo/redo, so
+ * truncating it here would desynchronize history from the document state and
+ * silently drop entries on undo/redo. Long sessions accumulate entries; hosts
+ * that need bounded history should persist/rotate it out-of-band.
+ */
+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;
+}