@beyondwork/docx-react-component 1.0.12 → 1.0.14

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@beyondwork/docx-react-component",
   "publisher": "beyondwork",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Embeddable React Word (docx) editor with review, comments, tracked changes, and round-trip OOXML fidelity.",
   "type": "module",
   "sideEffects": [
@@ -33,6 +33,14 @@
       "types": "./src/api/public-types.ts",
       "import": "./src/api/public-types.ts"
     },
+    "./io/docx-session": {
+      "types": "./src/io/docx-session.ts",
+      "import": "./src/io/docx-session.ts"
+    },
+    "./runtime/document-runtime": {
+      "types": "./src/runtime/document-runtime.ts",
+      "import": "./src/runtime/document-runtime.ts"
+    },
     "./ui-tailwind/theme/editor-theme.css": "./src/ui-tailwind/theme/editor-theme.css",
     "./package.json": "./package.json"
   },

package/src/api/public-types.ts

@@ -123,6 +123,48 @@ export interface TrackedChangesSnapshot {
   revisions: TrackedChangeEntrySnapshot[];
 }
 
+export type FormattingAlignment = "left" | "center" | "right" | "justify";
+
+export interface FormattingStateSnapshot {
+  bold: boolean;
+  italic: boolean;
+  underline: boolean;
+  strikethrough: boolean;
+  superscript: boolean;
+  subscript: boolean;
+  fontFamily?: string;
+  fontSize?: number;
+  textColor?: string;
+  highlightColor?: string | null;
+  alignment?: FormattingAlignment;
+}
+
+export interface SearchOptions {
+  matchCase?: boolean;
+  wholeWord?: boolean;
+  limit?: number;
+}
+
+export interface SearchResultSnapshot {
+  resultId: string;
+  anchor: EditorAnchorProjection;
+  excerpt: string;
+  isActive: boolean;
+}
+
+export interface InsertTableOptions {
+  rows: number;
+  columns: number;
+}
+
+export interface InsertImageOptions {
+  data: Uint8Array;
+  mimeType: string;
+  width?: number;
+  height?: number;
+  altText?: string;
+}
+
 export type SurfaceTextMark =
   | "bold"
   | "italic"
@@ -192,6 +234,7 @@ export interface SurfaceTableCellSnapshot {
   verticalMerge: "restart" | "continue" | null;
   colspan: number;
   rowspan: number;
+  backgroundColor?: string | null;
   content: SurfaceBlockSnapshot[];
 }
 
@@ -538,6 +581,35 @@ export interface WordReviewEditorRef {
   getWarnings(): EditorWarning[];
   getComments(): CommentSidebarSnapshot;
   getTrackedChanges(): TrackedChangesSnapshot;
+  getFormattingState(): FormattingStateSnapshot;
+  toggleBold(): void;
+  toggleItalic(): void;
+  toggleUnderline(): void;
+  toggleStrikethrough(): void;
+  toggleSuperscript(): void;
+  toggleSubscript(): void;
+  setFontFamily(fontFamily: string | null): void;
+  setFontSize(size: number | null): void;
+  setTextColor(color: string | null): void;
+  setHighlightColor(color: string | null): void;
+  setAlignment(alignment: FormattingAlignment): void;
+  indent(): void;
+  outdent(): void;
+  insertPageBreak(): void;
+  insertTable(options: InsertTableOptions): void;
+  insertImage(options: InsertImageOptions): void;
+  addRowBefore(): void;
+  addRowAfter(): void;
+  addColumnBefore(): void;
+  addColumnAfter(): void;
+  deleteRow(): void;
+  deleteColumn(): void;
+  deleteTable(): void;
+  mergeCells(): void;
+  splitCell(): void;
+  setCellBackground(color: string): void;
+  search(query: string, options?: SearchOptions): SearchResultSnapshot[];
+  clearSearch(): void;
   scrollToRevision(revisionId: string): void;
   scrollToComment(commentId: string): void;
 }