@beyondwork/docx-react-component 1.0.35 → 1.0.36

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@beyondwork/docx-react-component",
   "publisher": "beyondwork",
-  "version": "1.0.35",
+  "version": "1.0.36",
   "description": "Embeddable React Word (docx) editor with review, comments, tracked changes, and round-trip OOXML fidelity.",
   "type": "module",
   "sideEffects": [

package/src/api/public-types.ts

@@ -920,7 +920,7 @@ export type ViewMode = "editing" | "review" | "view";
  * Distinct from `ViewMode` (editor posture) and `WorkspaceMode` (shell layout).
  * `DocumentMode` reflects document-level editing authority, not presentation.
  */
-export type DocumentMode = "editing" | "suggesting" | "viewing";
+export type DocumentMode = "editing" | "suggesting" | "viewing" | "commenting";
 
 /**
  * A single permission range parsed from `w:permStart` / `w:permEnd` in the

package/src/core/commands/index.ts

@@ -195,7 +195,7 @@ export interface EditorTransaction {
 
 export interface CommandExecutionContext {
   timestamp: string;
-  documentMode?: "editing" | "suggesting" | "viewing";
+  documentMode?: "editing" | "suggesting" | "viewing" | "commenting";
   defaultAuthorId?: string;
 }
 

package/src/runtime/document-runtime.ts

@@ -738,7 +738,7 @@ export function createDocumentRuntime(
       });
     }
 
-    if (viewState.documentMode === "viewing") {
+    if (viewState.documentMode === "viewing" || viewState.documentMode === "commenting") {
       reasons.push({
         code: "document_viewing_mode",
         message: "Document is in viewing mode.",
@@ -822,8 +822,8 @@ export function createDocumentRuntime(
   function getEffectiveDocumentMode(
     selection: EditorState["selection"],
   ): DocumentMode {
-    if (viewState.documentMode === "viewing") {
-      return "viewing";
+    if (viewState.documentMode === "viewing" || viewState.documentMode === "commenting") {
+      return viewState.documentMode;
     }
     const matchingScope = getMatchingWorkflowScope(selection);
     if (matchingScope?.mode === "suggest") {
@@ -1529,13 +1529,13 @@ export function createDocumentRuntime(
       }
 
       if (command.type === "history.undo") {
-        if (viewState.documentMode === "viewing") return;
+        if (viewState.documentMode === "viewing" || viewState.documentMode === "commenting") return;
         applyHistory("undo");
         return;
       }
 
       if (command.type === "history.redo") {
-        if (viewState.documentMode === "viewing") return;
+        if (viewState.documentMode === "viewing" || viewState.documentMode === "commenting") return;
         applyHistory("redo");
         return;
       }

package/src/runtime/session-capabilities.ts

@@ -23,7 +23,7 @@ export interface SessionCapabilities {
 
   // ── Document mode ──
   /** Runtime document mode — editing authority, distinct from view/workspace mode. */
-  documentMode: "editing" | "suggesting" | "viewing";
+  documentMode: "editing" | "suggesting" | "viewing" | "commenting";
 
   // ── Command capabilities ──
   canUndo: boolean;
@@ -101,12 +101,15 @@ export function deriveCapabilities(
       ? "read-only-diagnostics"
       : reviewMode;
 
-  // Command capabilities — document mode "viewing" disables editing
-  const canEdit = isReady && !isReadOnly && !hasFatalError && documentMode !== "viewing";
+  // Command capabilities — "viewing" and "commenting" modes both disable editing;
+  // "commenting" additionally keeps comment creation enabled.
+  const canEdit = isReady && !isReadOnly && !hasFatalError
+    && documentMode !== "viewing" && documentMode !== "commenting";
   const canUndo = snapshot.commandState.canUndo && canEdit;
   const canRedo = snapshot.commandState.canRedo && canEdit;
+  const canComment = isReady && !hasFatalError && documentMode !== "viewing";
   const canAddComment =
-    canEdit &&
+    canComment &&
     activeStory.kind === "main" &&
     !snapshot.selection.isCollapsed &&
     Boolean(snapshot.surface) &&