@beyondwork/docx-react-component 1.0.28 → 1.0.30

package/src/api/public-types.ts

@@ -224,6 +224,8 @@ export interface CommentSidebarThreadSnapshot {
   createdBy: string;
   warningCount: number;
   anchorLabel: string;
+  detachedReason?: "incomplete-markers" | "multi-paragraph" | "opaque-region" | "revision-overlap";
+  actionabilityNote?: string;
   isActive: boolean;
   resolvedAt?: string;
   resolvedBy?: string;
@@ -232,6 +234,18 @@ export interface CommentSidebarThreadSnapshot {
 export interface TrackedChangeEntrySnapshot {
   revisionId: string;
   kind: "insertion" | "deletion" | "formatting" | "move" | "property-change";
+  source?: "runtime" | "import";
+  suggestionId?: string;
+  semanticKind?:
+    | "insertion"
+    | "deletion"
+    | "replacement"
+    | "formatting-change"
+    | "paragraph-property-change"
+    | "structural-change"
+    | "object-change";
+  linkedRevisionIds?: string[];
+  predecessorSuggestionId?: string;
   label: string;
   status: "active" | "accepted" | "rejected" | "detached";
   actionability: "actionable" | "preserve-only";
@@ -264,6 +278,45 @@ export interface TrackedChangesSnapshot {
   revisions: TrackedChangeEntrySnapshot[];
 }
 
+export interface SuggestionEntrySnapshot {
+  suggestionId: string;
+  kind:
+    | "insertion"
+    | "deletion"
+    | "replacement"
+    | "formatting-change"
+    | "paragraph-property-change"
+    | "structural-change"
+    | "object-change";
+  source: "runtime" | "import";
+  status: "active" | "accepted" | "rejected" | "detached";
+  actionability: "actionable" | "preserve-only";
+  storyTarget: EditorStoryTarget;
+  anchor: EditorAnchorProjection;
+  anchorLabel: string;
+  createdAt: string;
+  authorId: string;
+  changeIds: string[];
+  editable: boolean;
+  canAccept: boolean;
+  canReject: boolean;
+  isReplacement: boolean;
+  preserveOnlyReason?: string;
+  excerpt?: string;
+  detail?: string;
+}
+
+export interface SuggestionsSnapshot {
+  totalCount: number;
+  actionableSuggestionIds: string[];
+  preserveOnlySuggestionIds: string[];
+  activeSuggestionIds: string[];
+  acceptedSuggestionIds: string[];
+  rejectedSuggestionIds: string[];
+  detachedSuggestionIds: string[];
+  suggestions: SuggestionEntrySnapshot[];
+}
+
 export type FormattingAlignment = "left" | "center" | "right" | "justify";
 
 export interface FormattingBreadcrumbItem {
@@ -423,6 +476,118 @@ export interface TocRefreshResult {
   }>;
 }
 
+export type DocumentLocationSource =
+  | { kind: "selection" }
+  | { kind: "search"; resultId?: string; query?: string }
+  | { kind: "workflow"; markupId?: string; candidateId?: string }
+  | { kind: "navigation" };
+
+export interface DocumentLocationSnapshot {
+  locationId: string;
+  anchor: EditorAnchorProjection;
+  storyTarget?: EditorStoryTarget;
+  sectionIndex?: number;
+  pageIndex?: number;
+  headingId?: string;
+  headingPath?: string[];
+  bookmarkName?: string;
+  source: DocumentLocationSource;
+}
+
+export type RestorePointCheckpointType = "selection" | "search-result" | "workflow-item" | "manual";
+
+export interface RestorePointSnapshot {
+  restorePointId: string;
+  location: DocumentLocationSnapshot;
+  revisionToken: string;
+  createdAt: string;
+  checkpointType: RestorePointCheckpointType;
+}
+
+export interface RestoreResult {
+  status: "restored" | "remapped" | "detached" | "blocked";
+  selection?: SelectionSnapshot;
+  location?: DocumentLocationSnapshot;
+  reasons?: string[];
+}
+
+export interface DocumentOutlineHeadingSnapshot extends DocumentHeadingSnapshot {
+  parentHeadingIds: string[];
+}
+
+export interface DocumentOutlineSnapshot {
+  activeHeadingId?: string;
+  headings: DocumentOutlineHeadingSnapshot[];
+}
+
+export interface TocEntrySnapshot {
+  tocEntryId: string;
+  level: number;
+  text: string;
+  pageIndex?: number;
+  anchor?: EditorAnchorProjection;
+  bookmarkName?: string;
+  headingId?: string;
+}
+
+export interface TocSnapshot {
+  status: "current" | "stale" | "missing";
+  sourceFieldIndex?: number;
+  instruction?: string;
+  entries: TocEntrySnapshot[];
+}
+
+export interface DocumentSectionSnapshot {
+  sectionId: string;
+  sectionIndex: number;
+  pageRange: { start: number; end: number };
+  headingPath: string[];
+  primaryHeadingId?: string;
+  primaryHeadingText?: string;
+  layout?: PageLayoutSnapshot;
+  anchor: EditorAnchorProjection;
+  storyTargets: EditorStoryTarget[];
+}
+
+export type SnapshotRefreshInvalidateTarget =
+  | "selection"
+  | "render"
+  | "navigation"
+  | "fields"
+  | "comments"
+  | "trackedChanges"
+  | "workflowScope"
+  | "workflowMarkup"
+  | "reviewWork"
+  | "contextAnalytics"
+  | "chunks"
+  | "outline"
+  | "toc"
+  | "sections"
+  | "locations"
+  | "textStream";
+
+export type SnapshotRefreshStaleTarget =
+  | "search_results"
+  | "anchors"
+  | "selection_only"
+  | "none";
+
+export type SnapshotRefreshChangeKind =
+  | "selection"
+  | "content"
+  | "review"
+  | "workflow"
+  | "structure"
+  | "checkpoint";
+
+export interface SnapshotRefreshHints {
+  invalidate: SnapshotRefreshInvalidateTarget[];
+  staleTargets: SnapshotRefreshStaleTarget[];
+  changeKinds: SnapshotRefreshChangeKind[];
+  checkpointType?: "session" | "snapshot" | "export";
+}
+
 export interface StyleCatalogEntrySnapshot {
   styleId: string;
   displayName: string;
@@ -513,6 +678,8 @@ export type SurfaceInlineSegment =
       warningId: string;
       label: string;
       detail: string;
+      featureKey?: string;
+      blockedReasonCode?: "workflow_preserve_only" | "workflow_blocked_import";
       presentation?: "inline-chip" | "quiet-marker";
       state: "locked-preserve-only";
     }
@@ -560,6 +727,26 @@ export interface SurfaceTableRowSnapshot {
   isHeader?: boolean;
 }
 
+export interface ResolvedNumberingGeometrySnapshot {
+  markerJustification?: "left" | "center" | "right" | "both" | "distribute";
+  spacing?: { before?: number; after?: number; line?: number; lineRule?: string };
+  indentation?: { left?: number; right?: number; firstLine?: number; hanging?: number };
+  tabStops?: Array<{ pos: number; val?: string; leader?: string }>;
+  markerLane?: { start: number; width: number; textStart: number };
+  textColumn?: { start: number; right?: number; firstLine?: number; hanging?: number };
+}
+
+export interface ResolvedNumberingSnapshot {
+  level: number;
+  format: string;
+  text?: string;
+  startAt: number;
+  paragraphStyleId?: string;
+  isLegalNumbering?: boolean;
+  suffix?: "tab" | "space" | "nothing";
+  geometry: ResolvedNumberingGeometrySnapshot;
+}
+
 export type SurfaceBlockSnapshot =
   | {
       blockId: string;
@@ -573,6 +760,7 @@ export type SurfaceBlockSnapshot =
       };
       numberingPrefix?: string;
       numberingSuffix?: "tab" | "space" | "nothing";
+      resolvedNumbering?: ResolvedNumberingSnapshot;
       alignment?: "left" | "center" | "right" | "both" | "distribute";
       spacing?: { before?: number; after?: number; line?: number; lineRule?: string };
       contextualSpacing?: boolean;
@@ -631,6 +819,8 @@ export type SurfaceBlockSnapshot =
       warningId: string;
       label: string;
       detail: string;
+      featureKey?: string;
+      blockedReasonCode?: "workflow_preserve_only" | "workflow_blocked_import";
       state: "locked-preserve-only";
     };
 
@@ -797,6 +987,39 @@ export interface ActiveNoteContext {
   referencePosition: number;
 }
 
+export interface TableOperationCapabilitySnapshot {
+  enabled: boolean;
+  reason?: string;
+}
+
+export interface TableStructureContextSnapshot {
+  tableBlockIndex: number;
+  currentStyleId?: string | null;
+  selectionKind: "text" | "cell";
+  rowCount: number;
+  columnCount: number;
+  selectedCellCount: number;
+  isSimpleTable: boolean;
+  currentCell: {
+    rowIndex: number;
+    columnIndex: number;
+    isHeader: boolean;
+  };
+  operations: {
+    setTableStyle: TableOperationCapabilitySnapshot;
+    setCellBackground: TableOperationCapabilitySnapshot;
+    addRowBefore: TableOperationCapabilitySnapshot;
+    addRowAfter: TableOperationCapabilitySnapshot;
+    deleteRow: TableOperationCapabilitySnapshot;
+    addColumnBefore: TableOperationCapabilitySnapshot;
+    addColumnAfter: TableOperationCapabilitySnapshot;
+    deleteColumn: TableOperationCapabilitySnapshot;
+    mergeCells: TableOperationCapabilitySnapshot;
+    splitCell: TableOperationCapabilitySnapshot;
+    deleteTable: TableOperationCapabilitySnapshot;
+  };
+}
+
 export interface PageRegionHitTest {
   region: "body" | "header" | "footer" | "margin" | "gutter";
   sectionIndex: number;
@@ -869,6 +1092,7 @@ export interface EditorSessionState {
   warningLog: EditorWarning[];
   protectionSnapshot?: ProtectionSnapshot;
   sourcePackage?: RuntimePersistedEditorSnapshot["sourcePackage"];
+  workflowMetadata?: WorkflowMetadataSnapshot;
 }
 
 export interface PersistedEditorSnapshot {
@@ -885,6 +1109,7 @@ export interface PersistedEditorSnapshot {
   warningLog: EditorWarning[];
   protectionSnapshot?: ProtectionSnapshot;
   sourcePackage?: RuntimePersistedEditorSnapshot["sourcePackage"];
+  workflowMetadata?: WorkflowMetadataSnapshot;
 }
 
 export interface AddCommentParams {
@@ -928,6 +1153,7 @@ export interface WorkflowScope {
   workItemId?: string;
   label?: string;
   domain?: "legal" | "commercial" | "finance" | "other";
+  metadataRefs?: string[];
 }
 
 export interface WorkflowWorkItem {
@@ -947,6 +1173,36 @@ export interface WorkflowOverlay {
   activeWorkItemId?: string | null;
 }
 
+export type WorkflowMetadataPersistence =
+  | "runtime-only"
+  | "session"
+  | "document-metadata";
+
+export interface WorkflowMetadataDefinition {
+  metadataId: string;
+  kind: string;
+  label: string;
+  color?: string;
+  icon?: string;
+  dataSchema?: Record<string, unknown>;
+  persistence: WorkflowMetadataPersistence;
+}
+
+export interface WorkflowMetadataEntry {
+  entryId: string;
+  metadataId: string;
+  anchor: EditorAnchorProjection;
+  storyTarget?: EditorStoryTarget;
+  value?: Record<string, unknown>;
+  scopeId?: string;
+  workItemId?: string;
+}
+
+export interface WorkflowMetadataSnapshot {
+  definitions: WorkflowMetadataDefinition[];
+  entries: WorkflowMetadataEntry[];
+}
+
 export interface WorkflowBlockedCommandReason {
   code:
     | "outside_workflow_scope"
@@ -981,12 +1237,19 @@ export interface InteractionGuardSnapshot {
   effectiveMode: EffectiveSelectionMode;
   matchedScopeId?: string;
   matchedScopeMode?: WorkflowScopeMode;
+  targetAccess?: "direct-edit" | "suggest" | "comment-only" | "view-only" | "blocked";
+  commandCapabilities?: Array<{
+    family: "text" | "formatting" | "structure";
+    supported: boolean;
+    blockedReasons: WorkflowBlockedCommandReason[];
+  }>;
   disabledReason?: string;
   blockedReasons: WorkflowBlockedCommandReason[];
 }
 
 export type WorkflowMarkupKind =
   | "highlight"
+  | "metadata"
   | "comment"
   | "revision"
   | "field"
@@ -1008,6 +1271,18 @@ export interface WorkflowHighlightMarkup extends WorkflowMarkupBase {
   text: string;
 }
 
+export interface WorkflowMetadataMarkup extends WorkflowMarkupBase {
+  kind: "metadata";
+  entryId: string;
+  metadataId: string;
+  color?: string;
+  icon?: string;
+  persistence: WorkflowMetadataPersistence;
+  value?: Record<string, unknown>;
+  scopeId?: string;
+  workItemId?: string;
+}
+
 export interface WorkflowCommentMarkup extends WorkflowMarkupBase {
   kind: "comment";
   commentId: string;
@@ -1057,6 +1332,7 @@ export interface WorkflowOpaqueFragmentMarkup extends WorkflowMarkupBase {
 
 export type WorkflowMarkupItem =
   | WorkflowHighlightMarkup
+  | WorkflowMetadataMarkup
   | WorkflowCommentMarkup
   | WorkflowRevisionMarkup
   | WorkflowFieldMarkup
@@ -1067,6 +1343,7 @@ export interface WorkflowMarkupSnapshot {
   totalCount: number;
   items: WorkflowMarkupItem[];
   highlights: WorkflowHighlightMarkup[];
+  metadata: WorkflowMetadataMarkup[];
   comments: WorkflowCommentMarkup[];
   revisions: WorkflowRevisionMarkup[];
   fields: WorkflowFieldMarkup[];
@@ -1104,6 +1381,174 @@ export interface HostAnnotationSnapshot {
   annotations: HostAnnotationItem[];
 }
 
+export type ReviewQueueItemKind = "comment" | "change" | "section_mark";
+
+export interface ReviewQueueItem {
+  itemId: string;
+  kind: ReviewQueueItemKind;
+  label: string;
+  storyTarget?: EditorStoryTarget;
+  anchor: EditorAnchorProjection;
+  sectionIndex?: number;
+  pageIndex?: number;
+  status: "open" | "resolved";
+  actionable: boolean;
+}
+
+export interface ReviewQueueSnapshot {
+  totalCount: number;
+  openCount: number;
+  activeIndex: number;
+  items: ReviewQueueItem[];
+}
+
+export interface DocumentTextToken {
+  tokenId: string;
+  storyTarget?: EditorStoryTarget;
+  blockId: string;
+  blockKind: SurfaceBlockSnapshot["kind"];
+  segmentId?: string;
+  kind: SurfaceInlineSegment["kind"] | "paragraph_boundary" | "table_boundary";
+  from: number;
+  to: number;
+  text?: string;
+  marks?: SurfaceTextMark[];
+  pageIndex?: number;
+  sectionIndex?: number;
+}
+
+export interface StoryTextStreamSnapshot {
+  target: EditorStoryTarget;
+  label: string;
+  storySize: number;
+  tokens: DocumentTextToken[];
+}
+
+export type DocumentChunkKind = "retrieval" | "action" | "workflow";
+
+export interface DocumentChunkSnapshot {
+  chunkId: string;
+  kind: DocumentChunkKind;
+  label: string;
+  text: string;
+  storyTarget?: EditorStoryTarget;
+  anchor: EditorAnchorProjection;
+  sectionIndex?: number;
+  pageRange?: { start: number; end: number };
+  headingPath: string[];
+  blockRefs: Array<{ blockId: string; kind: string }>;
+  source:
+    | { type: "surface" }
+    | { type: "search"; query: string }
+    | { type: "workflow"; candidateId?: string; markupId?: string };
+  cautionFlags: Array<
+    | "contains_table"
+    | "contains_protected_range"
+    | "contains_preserve_only"
+    | "contains_detached_anchor"
+  >;
+}
+
+export interface ReviewWorkItemSnapshot {
+  workId: string;
+  kind: "comment" | "revision" | "protected_range" | "opaque_fragment";
+  label: string;
+  excerpt: string;
+  anchor: EditorAnchorProjection;
+  storyTarget?: EditorStoryTarget;
+  sectionIndex?: number;
+  pageIndex?: number;
+}
+
+export interface ReviewWorkSnapshot {
+  openCommentCount: number;
+  actionableRevisionCount: number;
+  items: ReviewWorkItemSnapshot[];
+}
+
+export type RuntimeContextAnalyticsScopeKind =
+  | "selection"
+  | "workflow_scope"
+  | "work_item"
+  | "document";
+
+export interface RuntimeContextAnalyticsQuery {
+  scopeKind?: RuntimeContextAnalyticsScopeKind;
+  scopeId?: string;
+  workItemId?: string;
+}
+
+export interface RuntimeContextAnalyticsBadge {
+  key: string;
+  label: string;
+  value?: string | number;
+  tone?: "neutral" | "accent" | "warning" | "danger" | "success";
+  priority?: 1 | 2 | 3;
+}
+
+export interface RuntimeContextAnalyticsActionHint {
+  key: string;
+  label: string;
+  kind: "next_step" | "blocker" | "warning" | "approval";
+}
+
+export interface RuntimeContextAnalyticsCounts {
+  tasksRemaining?: number;
+  unresolvedComments?: number;
+  pendingRevisions?: number;
+  pendingSuggestions?: number;
+  blockedCommands?: number;
+  approvalsRemaining?: number;
+  overdueItems?: number;
+  warnings?: number;
+  errors?: number;
+  openWorkItems?: number;
+  exportBlockers?: number;
+}
+
+export interface RuntimeContextAnalyticsState {
+  effectiveMode?: EffectiveSelectionMode;
+  isBlocked?: boolean;
+  disabledReason?: string;
+  completionState?: "not_started" | "in_progress" | "ready" | "done";
+  exportReadiness?: "ready" | "warning" | "blocked";
+  lastTouchedAt?: string;
+}
+
+export type RuntimeContextAnalyticsUnavailableField =
+  | "tasksRemaining"
+  | "approvalsRemaining"
+  | "overdueItems"
+  | "tags"
+  | "assignee"
+  | "dueDate"
+  | "lastTouchedAt";
+
+export interface RuntimeContextAnalyticsProvenance {
+  kind: "runtime-derived";
+  derivedFrom: Array<
+    | "render"
+    | "workflowScope"
+    | "interactionGuard"
+    | "workflowMarkup"
+    | "reviewWork"
+    | "warnings"
+    | "compatibility"
+  >;
+  unavailable: RuntimeContextAnalyticsUnavailableField[];
+}
+
+export interface RuntimeContextAnalyticsSnapshot {
+  scopeKind: RuntimeContextAnalyticsScopeKind;
+  scopeId?: string;
+  workItemId?: string | null;
+  badges: RuntimeContextAnalyticsBadge[];
+  nextActions: RuntimeContextAnalyticsActionHint[];
+  counts: RuntimeContextAnalyticsCounts;
+  state: RuntimeContextAnalyticsState;
+  provenance: RuntimeContextAnalyticsProvenance;
+}
+
 export interface WorkflowCandidateRangeOptions {
   kinds?: WorkflowMarkupKind[];
   includeDetached?: boolean;
@@ -1217,17 +1662,47 @@ export type WordReviewEditorEvent =
       documentId: string;
       activeWorkItemId: string | null;
     }
+  | {
+      type: "workflow_metadata_changed";
+      documentId: string;
+      snapshot: WorkflowMetadataSnapshot;
+    }
   | {
       type: "host_annotation_overlay_changed";
       documentId: string;
       snapshot: HostAnnotationSnapshot;
     }
+  | {
+      type: "context_analytics_changed";
+      documentId: string;
+      snapshot: RuntimeContextAnalyticsSnapshot | null;
+    }
   | {
       type: "change_authored";
       documentId: string;
       changeId: string;
       kind: "insertion" | "deletion";
     }
+  | {
+      type: "suggestion_authored";
+      documentId: string;
+      suggestionId: string;
+      changeIds: string[];
+      suggestionKind: SuggestionEntrySnapshot["kind"];
+      storyTarget: EditorStoryTarget;
+      anchor: EditorAnchorProjection;
+      isReplacement: boolean;
+    }
+  | {
+      type: "suggestion_updated";
+      documentId: string;
+      suggestionId: string;
+      changeIds: string[];
+      suggestionKind: SuggestionEntrySnapshot["kind"];
+      status: SuggestionEntrySnapshot["status"];
+      storyTarget: EditorStoryTarget;
+      anchor: EditorAnchorProjection;
+    }
   | {
       type: "command_blocked";
       documentId: string;
@@ -1312,12 +1787,15 @@ export interface WordReviewEditorRef {
   getWarnings(): EditorWarning[];
   getCommentSidebarSnapshot(): CommentSidebarSnapshot;
   getTrackedChangesSnapshot(): TrackedChangesSnapshot;
+  getSuggestionsSnapshot(): SuggestionsSnapshot;
   getComments(): CommentSidebarSnapshot;
   getTrackedChanges(): TrackedChangesSnapshot;
   isDirty(): boolean;
   getFormattingState(): FormattingStateSnapshot;
   getStyleCatalog(): StyleCatalogSnapshot;
   replaceText(text: string, target?: EditorAnchorProjection): void;
+  toggleBulletedList(): void;
+  toggleNumberedList(): void;
   toggleBold(): void;
   toggleItalic(): void;
   toggleUnderline(): void;
@@ -1333,6 +1811,8 @@ export interface WordReviewEditorRef {
   setTableStyle(styleId: string | null): void;
   indent(): void;
   outdent(): void;
+  restartNumbering(): void;
+  continueNumbering(): void;
   insertPageBreak(): void;
   insertTable(options: InsertTableOptions): void;
   insertImage(options: InsertImageOptions): void;
@@ -1355,6 +1835,28 @@ export interface WordReviewEditorRef {
   closeStory(): void;
   getPageLayoutSnapshot(): PageLayoutSnapshot | null;
   getDocumentNavigationSnapshot(): DocumentNavigationSnapshot;
+  getCurrentLocation(): DocumentLocationSnapshot | null;
+  getLocationForSelection(selection: SelectionSnapshot): DocumentLocationSnapshot | null;
+  getLocationForAnchor(
+    anchor: EditorAnchorProjection,
+    storyTarget?: EditorStoryTarget,
+  ): DocumentLocationSnapshot | null;
+  captureRestorePoint(
+    input?: SelectionSnapshot | EditorAnchorProjection,
+  ): RestorePointSnapshot | null;
+  restoreToPoint(
+    point: RestorePointSnapshot,
+    options?: { behavior?: "exact" | "semantic"; scroll?: boolean },
+  ): RestoreResult;
+  getOutlineSnapshot(): DocumentOutlineSnapshot;
+  getTocSnapshot(): TocSnapshot | null;
+  getSections(): DocumentSectionSnapshot[];
+  getSectionSnapshot(input: {
+    sectionIndex?: number;
+    headingId?: string;
+    bookmarkName?: string;
+  }): DocumentSectionSnapshot | null;
+  describeEventImpact(event: WordReviewEditorEvent): SnapshotRefreshHints;
   getFieldSnapshot(): FieldSnapshot;
   updateFields(options?: UpdateFieldsOptions): UpdateFieldsResult;
   updateTableOfContents(options?: TocRefreshOptions): TocRefreshResult;
@@ -1378,11 +1880,36 @@ export interface WordReviewEditorRef {
   getWorkflowScopeSnapshot(): WorkflowScopeSnapshot | null;
   getInteractionGuardSnapshot(): InteractionGuardSnapshot;
   getWorkflowMarkupSnapshot(): WorkflowMarkupSnapshot;
+  setWorkflowMetadataDefinitions(definitions: WorkflowMetadataDefinition[]): void;
+  clearWorkflowMetadataDefinitions(): void;
+  setWorkflowMetadataEntries(entries: WorkflowMetadataEntry[]): void;
+  clearWorkflowMetadataEntries(): void;
+  getWorkflowMetadataSnapshot(): WorkflowMetadataSnapshot;
   setHostAnnotationOverlay(overlay: HostAnnotationOverlay): void;
   clearHostAnnotationOverlay(): void;
   getHostAnnotationSnapshot(): HostAnnotationSnapshot;
+  getReviewQueueSnapshot(): ReviewQueueSnapshot;
+  goToNextReviewItem(): ReviewQueueItem | null;
+  goToPreviousReviewItem(): ReviewQueueItem | null;
+  markSectionForReview(input?: { sectionIndex?: number; label?: string }): string | null;
+  clearSectionReviewMark(annotationId: string): void;
   getWorkflowCandidateRanges(options?: WorkflowCandidateRangeOptions): WorkflowCandidateRange[];
   replaceWorkflowMarkupText(markupId: string, text: string): void;
+  getRuntimeContextAnalytics(
+    query?: RuntimeContextAnalyticsQuery,
+  ): RuntimeContextAnalyticsSnapshot | null;
+}
+
+export type WordReviewEditorChromePreset =
+  | "selection"
+  | "simple"
+  | "advanced"
+  | "review";
+
+export interface WordReviewEditorChromeOptions {
+  showReviewQueueBar: boolean;
+  showSectionTagAction: boolean;
+  showReviewRail: boolean;
 }
 
 export interface WordReviewEditorProps {
@@ -1399,7 +1926,10 @@ export interface WordReviewEditorProps {
   readOnly?: boolean;
   reviewMode?: "editing" | "review";
   suggestionsEnabled?: boolean;
+  chromePreset?: WordReviewEditorChromePreset;
+  chromeOptions?: Partial<WordReviewEditorChromeOptions>;
   markupDisplay?: "clean" | "simple" | "all";
+  showUnsupportedObjectPreviews?: boolean;
   showReviewPanel?: boolean;
   chromeVisibility?: Partial<WordReviewEditorChromeVisibility>;
   hostAdapter?: EditorHostAdapter;
@@ -1415,6 +1945,7 @@ export interface WordReviewEditorChromeVisibility {
   alerts: boolean;
   selectionOverlay: boolean;
   contextToolbars: boolean;
+  contextAnalytics: boolean;
   pageChrome: boolean;
   statusBar: boolean;
   reviewRail: boolean;