SD-2261 - fix(types): expand definitions and exports to pass compilation

packages/super-editor/src/index.d.ts

@@ -77,7 +77,20 @@ export type Command = (props: CommandProps) => boolean;
  * Chainable command object returned by editor.chain()
  */
 export interface ChainableCommandObject {
-  run: () => boolean;
+  /** Execute the chained commands */
+  run(): boolean;
+  /** Chain any command - returns self for further chaining */
+  toggleBold(): ChainableCommandObject;
+  toggleItalic(): ChainableCommandObject;
+  toggleUnderline(): ChainableCommandObject;
+  toggleStrike(): ChainableCommandObject;
+  setFontSize(size: string | number): ChainableCommandObject;
+  setFontFamily(family: string): ChainableCommandObject;
+  setTextColor(color: string): ChainableCommandObject;
+  setTextAlign(alignment: 'left' | 'center' | 'right' | 'justify'): ChainableCommandObject;
+  insertContent(content: any): ChainableCommandObject;
+  focus(position?: 'start' | 'end' | 'all' | number | boolean | null): ChainableCommandObject;
+  /** Allow any other command */
   [commandName: string]: ((...args: any[]) => ChainableCommandObject) | (() => boolean);
 }
 
@@ -199,6 +212,67 @@ export interface OpenOptions {
   fonts?: Record<string, unknown>;
 }
 
+// ============================================
+// COMMENT TYPES
+// ============================================
+
+/** A comment element (paragraph, text run, etc.) */
+export interface CommentElement {
+  type: string;
+  content?: CommentElement[];
+  text?: string;
+}
+
+/** A comment in the document */
+export interface Comment {
+  /** Unique comment identifier */
+  commentId: string;
+  /** Timestamp when comment was created */
+  createdTime: number;
+  /** Email of the comment author */
+  creatorEmail: string;
+  /** Display name of the comment author */
+  creatorName: string;
+  /** Comment content elements */
+  elements: CommentElement[];
+  /** Original ID from imported document */
+  importedId?: string;
+  /** Whether the comment is resolved */
+  isDone: boolean;
+  /** Parent comment ID for replies */
+  parentCommentId?: string;
+  /** Raw JSON representation */
+  commentJSON?: unknown;
+}
+
+/** Event data for comments loaded event */
+export interface CommentsLoadedEventData {
+  comments: Comment[];
+}
+
+/** Event data for content error event */
+export interface ContentErrorEventData {
+  error: Error;
+}
+
+/** Font configuration */
+export interface FontConfig {
+  key: string;
+  label: string;
+  fontWeight?: number;
+  props?: {
+    style?: {
+      fontFamily?: string;
+    };
+  };
+}
+
+/** Font support information */
+export interface FontSupportInfo {
+  documentFonts: string[];
+  unsupportedFonts: string[];
+}
+
 // ============================================
 // PRESENTATION EDITOR TYPES
 // ============================================
@@ -586,6 +660,131 @@ export declare class Editor {
    */
   isEmpty: boolean;
 
+  // ============================================
+  // EVENT METHODS
+  // ============================================
+
+  /**
+   * Register an event listener.
+   * @param event - Event name ('update', 'create', 'transaction', etc.)
+   * @param handler - Event handler function
+   */
+  on(event: string, handler: (...args: any[]) => void): void;
+
+  /**
+   * Remove an event listener.
+   * @param event - Event name
+   * @param handler - Event handler function to remove
+   */
+  off(event: string, handler: (...args: any[]) => void): void;
+
+  /**
+   * Emit an event.
+   * @param event - Event name
+   * @param args - Arguments to pass to handlers
+   */
+  emit(event: string, ...args: any[]): void;
+
+  // ============================================
+  // DOCUMENT EXPORT METHODS
+  // ============================================
+
+  /**
+   * Export the document to DOCX format.
+   * @param options - Export options
+   * @returns Promise resolving to Blob (browser) or Buffer (Node.js)
+   */
+  exportDocx(options?: {
+    isFinalDoc?: boolean;
+    commentsType?: string;
+    comments?: Comment[];
+    fieldsHighlightColor?: string | null;
+    compression?: 'DEFLATE' | 'STORE';
+  }): Promise<Blob | ArrayBuffer>;
+
+  /**
+   * Export the document (alias for exportDocx).
+   */
+  exportDocument(options?: {
+    isFinalDoc?: boolean;
+    commentsType?: string;
+    comments?: Comment[];
+  }): Promise<Blob | ArrayBuffer>;
+
+  /**
+   * Save the document to the original source path (Node.js only).
+   */
+  save(options?: { isFinalDoc?: boolean; commentsType?: string; comments?: Comment[] }): Promise<void>;
+
+  /**
+   * Save the document to a specific path (Node.js only).
+   */
+  saveTo(
+    path: string,
+    options?: {
+      isFinalDoc?: boolean;
+      commentsType?: string;
+      comments?: Comment[];
+    },
+  ): Promise<void>;
+
+  // ============================================
+  // TOOLBAR & UI METHODS
+  // ============================================
+
+  /**
+   * Set the toolbar for this editor.
+   */
+  setToolbar(toolbar: any): void;
+
+  /**
+   * Set whether the editor is editable.
+   */
+  setEditable(editable: boolean, emitUpdate?: boolean): void;
+
+  /**
+   * Set the document mode.
+   */
+  setDocumentMode(mode: 'editing' | 'viewing' | 'suggesting'): void;
+
+  /**
+   * Focus the editor.
+   */
+  focus(): void;
+
+  /**
+   * Blur the editor.
+   */
+  blur(): void;
+
+  // ============================================
+  // DOCUMENT METHODS
+  // ============================================
+
+  /**
+   * Open a document.
+   */
+  open(source?: string | File | Blob | BinaryData, options?: OpenOptions): Promise<void>;
+
+  /**
+   * Close the current document.
+   */
+  close(): void;
+
+  /**
+   * Replace the current file.
+   */
+  replaceFile(newFile: File | Blob | BinaryData): Promise<void>;
+
+  /**
+   * Get the document as Markdown.
+   */
+  getMarkdown(): Promise<string>;
+
+  /**
+   * Check if the editor is currently active/focused.
+   */
+  isFocused: boolean;
   // --- Tracked selection handle API ---
 
   /** Capture the live PM selection as a tracked handle. Local-only. */
@@ -997,8 +1196,15 @@ export declare class PresentationEditor {
    */
   emit(event: string, ...args: any[]): void;
 
-  /** Allow additional properties */
-  [key: string]: any;
+  /**
+   * Replace the current file.
+   */
+  replaceFile(newFile: File | Blob | BinaryData): Promise<void>;
+
+  /**
+   * Set the toolbar for the editor.
+   */
+  setToolbar(toolbar: any): void;
 }
 
 // ============================================

packages/superdoc/src/index.js

@@ -1,6 +1,8 @@
 import {
   SuperConverter,
   Editor,
+  PresentationEditor,
+  getStarterExtensions,
   getRichTextExtensions,
   createZip,
   Extensions,
@@ -10,18 +12,96 @@ import {
   trackChangesHelpers,
   AnnotatorHelpers,
   SectionHelpers,
+  // Additional runtime exports
+  DocxZipper,
+  SuperToolbar,
+  getMarksFromSelection,
+  getActiveFormatting,
+  getAllowedImageDimensions,
+  isNodeType,
+  assertNodeType,
+  isMarkType,
+  defineNode,
+  defineMark,
+  TrackChangesBasePluginKey,
+  CommentsPluginKey,
+  // Vue components
+  SuperEditor,
+  SuperInput,
+  BasicUpload,
+  Toolbar,
+  AIWriter,
+  ContextMenu,
+  SlashMenu,
 } from '@superdoc/super-editor';
 import { DOCX, PDF, HTML, getFileObject, compareVersions } from '@superdoc/common';
 import BlankDOCX from '@superdoc/common/data/blank.docx?url';
 import { getSchemaIntrospection } from './helpers/schema-introspection.js';
 
+// ============================================
+// TYPE RE-EXPORTS
+// These types are defined in @superdoc/super-editor and re-exported for consumers
+// ============================================
+
+/**
+ * @typedef {import('@superdoc/super-editor').EditorState} EditorState
+ * @typedef {import('@superdoc/super-editor').Transaction} Transaction
+ * @typedef {import('@superdoc/super-editor').Schema} Schema
+ * @typedef {import('@superdoc/super-editor').EditorView} EditorView
+ * @typedef {import('@superdoc/super-editor').EditorCommands} EditorCommands
+ * @typedef {import('@superdoc/super-editor').ChainedCommand} ChainedCommand
+ * @typedef {import('@superdoc/super-editor').ChainableCommandObject} ChainableCommandObject
+ * @typedef {import('@superdoc/super-editor').CommandProps} CommandProps
+ * @typedef {import('@superdoc/super-editor').Command} Command
+ * @typedef {import('@superdoc/super-editor').CanObject} CanObject
+ * @typedef {import('@superdoc/super-editor').PresentationEditorOptions} PresentationEditorOptions
+ * @typedef {import('@superdoc/super-editor').LayoutEngineOptions} LayoutEngineOptions
+ * @typedef {import('@superdoc/super-editor').PageSize} PageSize
+ * @typedef {import('@superdoc/super-editor').PageMargins} PageMargins
+ * @typedef {import('@superdoc/super-editor').VirtualizationOptions} VirtualizationOptions
+ * @typedef {import('@superdoc/super-editor').TrackedChangesMode} TrackedChangesMode
+ * @typedef {import('@superdoc/super-editor').TrackedChangesOverrides} TrackedChangesOverrides
+ * @typedef {import('@superdoc/super-editor').LayoutMode} LayoutMode
+ * @typedef {import('@superdoc/super-editor').PresenceOptions} PresenceOptions
+ * @typedef {import('@superdoc/super-editor').RemoteUserInfo} RemoteUserInfo
+ * @typedef {import('@superdoc/super-editor').RemoteCursorState} RemoteCursorState
+ * @typedef {import('@superdoc/super-editor').Layout} Layout
+ * @typedef {import('@superdoc/super-editor').LayoutPage} LayoutPage
+ * @typedef {import('@superdoc/super-editor').LayoutFragment} LayoutFragment
+ * @typedef {import('@superdoc/super-editor').RangeRect} RangeRect
+ * @typedef {import('@superdoc/super-editor').BoundingRect} BoundingRect
+ * @typedef {import('@superdoc/super-editor').LayoutError} LayoutError
+ * @typedef {import('@superdoc/super-editor').LayoutMetrics} LayoutMetrics
+ * @typedef {import('@superdoc/super-editor').PositionHit} PositionHit
+ * @typedef {import('@superdoc/super-editor').FlowBlock} FlowBlock
+ * @typedef {import('@superdoc/super-editor').Measure} Measure
+ * @typedef {import('@superdoc/super-editor').SectionMetadata} SectionMetadata
+ * @typedef {import('@superdoc/super-editor').PaintSnapshot} PaintSnapshot
+ * @typedef {import('@superdoc/super-editor').LayoutUpdatePayload} LayoutUpdatePayload
+ * @typedef {import('@superdoc/super-editor').OpenOptions} OpenOptions
+ * @typedef {import('@superdoc/super-editor').DocxFileEntry} DocxFileEntry
+ * @typedef {import('@superdoc/super-editor').BinaryData} BinaryData
+ * @typedef {import('@superdoc/super-editor').UnsupportedContentItem} UnsupportedContentItem
+ * @typedef {import('@superdoc/super-editor').Comment} Comment
+ * @typedef {import('@superdoc/super-editor').CommentElement} CommentElement
+ * @typedef {import('@superdoc/super-editor').CommentsLoadedEventData} CommentsLoadedEventData
+ * @typedef {import('@superdoc/super-editor').ContentErrorEventData} ContentErrorEventData
+ * @typedef {import('@superdoc/super-editor').FontConfig} FontConfig
+ * @typedef {import('@superdoc/super-editor').FontSupportInfo} FontSupportInfo
+ * @typedef {import('@superdoc/super-editor').SelectionHandle} SelectionHandle
+ * @typedef {import('@superdoc/super-editor').SelectionCommandContext} SelectionCommandContext
+ * @typedef {import('@superdoc/super-editor').ResolveRangeOutput} ResolveRangeOutput
+ */
+
 // Public exports
 export { SuperDoc } from './core/SuperDoc.js';
 export {
   BlankDOCX,
   getFileObject,
   compareVersions,
   Editor,
+  PresentationEditor,
+  getStarterExtensions,
   getRichTextExtensions,
   getSchemaIntrospection,
 
@@ -31,7 +111,7 @@ export {
   HTML,
 
   // Helpers
-  superEditorHelpers,
+  superEditorHelpers as helpers,
   fieldAnnotationHelpers,
   trackChangesHelpers,
   AnnotatorHelpers,
@@ -45,4 +125,33 @@ export {
   Extensions,
   /** @internal */
   registeredHandlers,
+
+  // Additional classes
+  DocxZipper,
+  SuperToolbar,
+
+  // Helper functions
+  getMarksFromSelection,
+  getActiveFormatting,
+  getAllowedImageDimensions,
+
+  // Type guards and extension helpers
+  isNodeType,
+  assertNodeType,
+  isMarkType,
+  defineNode,
+  defineMark,
+
+  // Plugin keys
+  TrackChangesBasePluginKey,
+  CommentsPluginKey,
+
+  // Vue components
+  SuperEditor,
+  SuperInput,
+  BasicUpload,
+  Toolbar,
+  AIWriter,
+  ContextMenu,
+  SlashMenu,
 };