@productcloudos/editor 1.0.0

package/dist/types/lib/core/PCEditor.d.ts

@@ -0,0 +1,761 @@
+import { EditorOptions, DocumentData, DataBindingContext, PDFExportOptions, EditorSelection, EditingSection } from '../types';
+import { EventEmitter } from '../events/EventEmitter';
+import { BaseEmbeddedObject, ObjectPosition, TextBoxObject, TableObject, ImageObject, TableRowConfig } from '../objects';
+import { SubstitutionFieldConfig, TextFormattingStyle, SubstitutionField, RepeatingSection, FlowingTextContent, TextAlignment } from '../text';
+import { PDFImportProgress, PDFImportResult } from '../import';
+import { PDFImportOptions } from '../import/types';
+export declare class PCEditor extends EventEmitter {
+    private container;
+    private options;
+    private document;
+    private canvasManager;
+    private dataBinder;
+    private pdfGenerator;
+    private layoutEngine;
+    private transactionManager;
+    private textMutationObserver;
+    private objectMutationObserver;
+    private _contentDiscovery;
+    private mutationUndo;
+    private _isReady;
+    private keyboardListenerActive;
+    private currentSelection;
+    private _activeEditingSection;
+    private _wasTextEditing;
+    private _textEditingSource;
+    private clipboardManager;
+    constructor(container: HTMLElement, options?: EditorOptions);
+    private mergeOptions;
+    private initialize;
+    private setupContainer;
+    private setupEventListeners;
+    /**
+     * Get the FlowingTextContent for a specific section.
+     */
+    private getFlowingContentForSection;
+    /**
+     * Set up the new transaction-based undo system.
+     */
+    private setupTransactionUndo;
+    /**
+     * Find an embedded object by ID across all content sources.
+     */
+    private findObjectById;
+    /**
+     * Observe all embedded objects for undo/redo tracking.
+     */
+    private observeAllEmbeddedObjects;
+    /**
+     * Observe a single embedded object for undo/redo tracking.
+     */
+    private observeEmbeddedObject;
+    get isReady(): boolean;
+    /**
+     * Get the current selection state.
+     * Returns a union type indicating text selection, element selection, or no selection.
+     */
+    getSelection(): EditorSelection;
+    /**
+     * Get the text selection directly from the active FlowingTextContent.
+     * This is a more direct query than getSelection() which relies on event tracking.
+     * Returns null if no text is selected.
+     */
+    getTextSelection(): {
+        start: number;
+        end: number;
+    } | null;
+    /**
+     * Get the currently active editing section (header, body, or footer).
+     */
+    getActiveSection(): EditingSection;
+    /**
+     * Set the active editing section.
+     * This changes which section receives keyboard input and cursor positioning.
+     */
+    setActiveSection(section: EditingSection): void;
+    /**
+     * Get the FlowingTextContent for the currently active section.
+     */
+    private getActiveFlowingContent;
+    /**
+     * Emit the unified selection-change event.
+     */
+    private emitSelectionChange;
+    /**
+     * Emit a cursor changed event for the focused table cell.
+     */
+    private emitTableCellCursorChanged;
+    /**
+     * Get the current text editing source type.
+     * Returns null if no text is being edited.
+     */
+    private getTextEditingSource;
+    /**
+     * Check if text editing state changed and emit appropriate events.
+     */
+    private checkAndEmitTextEditingEvents;
+    loadDocument(documentData: DocumentData): void;
+    getDocument(): DocumentData;
+    bindData(data: DataBindingContext): void;
+    exportPDF(options?: PDFExportOptions): Promise<Blob>;
+    /**
+     * Save the current document state to a JSON string.
+     * @returns JSON string representation of the document
+     */
+    saveDocument(): string;
+    /**
+     * Save the current document state to a downloadable file.
+     * @param filename Optional filename (defaults to 'document.pceditor.json')
+     */
+    saveDocumentToFile(filename?: string): void;
+    /**
+     * Load a document from a JSON string.
+     * @param jsonString JSON string representation of the document
+     */
+    loadDocumentFromJSON(jsonString: string): void;
+    /**
+     * Load a document from a File object.
+     * @param file File object to load
+     * @returns Promise that resolves when loading is complete
+     */
+    loadDocumentFromFile(file: File): Promise<void>;
+    /**
+     * Import a PDF document and load it into the editor.
+     * @param source - PDF file as File, ArrayBuffer, or URL string
+     * @param options - Import options
+     * @param onProgress - Optional progress callback
+     * @returns Promise with import result including warnings and metadata
+     */
+    importPDF(source: File | ArrayBuffer | string, options?: PDFImportOptions, onProgress?: (progress: PDFImportProgress) => void): Promise<PDFImportResult>;
+    /**
+     * Validate document data structure before loading.
+     * @throws Error if validation fails
+     */
+    private validateDocumentData;
+    selectElement(elementId: string): void;
+    clearSelection(): void;
+    removeEmbeddedObject(objectId: string): void;
+    /**
+     * Undo the last operation.
+     */
+    undo(): void;
+    /**
+     * Redo the last undone operation.
+     */
+    redo(): void;
+    /**
+     * Check if undo is available.
+     */
+    canUndo(): boolean;
+    /**
+     * Check if redo is available.
+     */
+    canRedo(): boolean;
+    /**
+     * Clear undo/redo history.
+     */
+    clearUndoHistory(): void;
+    /**
+     * Set the maximum number of undo entries.
+     */
+    setMaxUndoHistory(count: number): void;
+    zoomIn(): void;
+    zoomOut(): void;
+    setZoom(level: number): void;
+    /**
+     * Get the current zoom level.
+     */
+    getZoomLevel(): number;
+    /**
+     * Get the container element for the editor.
+     */
+    getContainer(): HTMLElement;
+    /**
+     * Get the current scroll position of the editor viewport.
+     */
+    getScrollPosition(): {
+        x: number;
+        y: number;
+    };
+    /**
+     * Get the offset of the document content within the viewport.
+     * This is where the first page starts relative to the scroll viewport origin.
+     */
+    getContentOffset(): {
+        x: number;
+        y: number;
+    };
+    fitToWidth(): void;
+    /**
+     * Force a re-render of the canvas.
+     */
+    render(): void;
+    fitToPage(): void;
+    setAutoFlow(enabled: boolean): void;
+    reflowDocument(): void;
+    setSnapToGrid(enabled: boolean): void;
+    getDocumentMetrics(): {
+        pageWidth: number;
+        pageHeight: number;
+        margins: {
+            top: number;
+            right: number;
+            bottom: number;
+            left: number;
+        };
+        totalPages: number;
+    } | null;
+    addPage(): void;
+    removePage(pageId: string): void;
+    private setupKeyboardListeners;
+    private handleKeyDown;
+    /**
+     * Handle Escape key when there are selected elements (not in editing mode).
+     * Clears selection and returns cursor focus to the flowing text.
+     */
+    private handleEscapeForSelectedElements;
+    /**
+     * Find embedded object info by ID across all flowing content sources.
+     */
+    private findEmbeddedObjectInfo;
+    /**
+     * Find the parent FlowingTextContent for an embedded object and return focus to it.
+     */
+    private returnFocusToParentFlowingContent;
+    /**
+     * Handle vertical navigation for the focused control.
+     * This needs special handling because it requires layout context.
+     */
+    private handleVerticalNavigation;
+    enableTextInput(): void;
+    disableTextInput(): void;
+    /**
+     * Check if a text box is currently being edited.
+     */
+    isEditingTextBox(): boolean;
+    /**
+     * Check if any text content is being edited (body, header, footer, text box, or table cell).
+     * This is a unified check for determining if the formatting pane should be shown.
+     */
+    isTextEditing(): boolean;
+    private _savedEditingContext;
+    /**
+     * Get the FlowingTextContent currently being edited, regardless of context.
+     * Works for body text, text boxes, and table cells.
+     * Returns null if no text is being edited.
+     */
+    getEditingFlowingContent(): FlowingTextContent | null;
+    /**
+     * Save the current editing context (FlowingTextContent and selection).
+     * Call this before UI elements steal focus (e.g., dropdown opens).
+     */
+    saveEditingContext(): void;
+    /**
+     * Get the saved editing context selection, or the current selection if available.
+     */
+    getSavedOrCurrentSelection(): {
+        start: number;
+        end: number;
+    } | null;
+    /**
+     * Apply formatting using the saved context if current context is not available.
+     * This is useful when UI controls have stolen focus.
+     */
+    applyFormattingWithFallback(start: number, end: number, formatting: Partial<TextFormattingStyle>): void;
+    /**
+     * Set pending formatting to apply to the next inserted character.
+     * Used when formatting is applied with just a cursor (no selection).
+     */
+    setPendingFormatting(formatting: Partial<TextFormattingStyle>): void;
+    /**
+     * Get the current pending formatting, if any.
+     */
+    getPendingFormatting(): Partial<TextFormattingStyle> | null;
+    /**
+     * Check if there is pending formatting.
+     */
+    hasPendingFormatting(): boolean;
+    /**
+     * Clear pending formatting.
+     */
+    clearPendingFormatting(): void;
+    /**
+     * Clear the saved editing context.
+     */
+    clearSavedEditingContext(): void;
+    /**
+     * Get the currently editing text box, if any.
+     */
+    getEditingTextBox(): TextBoxObject | null;
+    /**
+     * Get the selection from the currently editing text box.
+     * Returns null if no text box is being edited or no selection.
+     */
+    getTextBoxSelection(): {
+        start: number;
+        end: number;
+    } | null;
+    /**
+     * Apply formatting to the selection in the currently editing text box.
+     */
+    applyTextBoxFormatting(start: number, end: number, formatting: Partial<TextFormattingStyle>): void;
+    /**
+     * Get the formatting at the cursor position in the editing text box.
+     */
+    getTextBoxFormattingAtCursor(): TextFormattingStyle | null;
+    /**
+     * Set the alignment for the current paragraph or selection in the editing text box.
+     * If there's a text selection, applies to all paragraphs in the selection.
+     * Otherwise applies to the paragraph at cursor.
+     */
+    setTextBoxAlignment(alignment: TextAlignment): void;
+    /**
+     * Get the alignment at the cursor position in the editing text box.
+     */
+    getTextBoxAlignmentAtCursor(): TextAlignment;
+    /**
+     * Get the formatting at the cursor position in whatever text is being edited.
+     * Works for body text, text boxes, and table cells.
+     * Considers pending formatting if present.
+     */
+    getUnifiedFormattingAtCursor(): TextFormattingStyle | null;
+    /**
+     * Apply formatting to the current selection in whatever text is being edited.
+     * Works for body text, text boxes, and table cells.
+     */
+    applyUnifiedFormatting(start: number, end: number, formatting: Partial<TextFormattingStyle>): void;
+    /**
+     * Get the selection from whatever text is being edited.
+     * Works for body text, text boxes, and table cells.
+     */
+    getUnifiedSelection(): {
+        start: number;
+        end: number;
+    } | null;
+    /**
+     * Get the alignment at the cursor position in whatever text is being edited.
+     * Works for body text, text boxes, and table cells.
+     */
+    getUnifiedAlignmentAtCursor(): TextAlignment;
+    /**
+     * Set the alignment for the current paragraph or selection in whatever text is being edited.
+     * Works for body text, text boxes, and table cells.
+     */
+    setUnifiedAlignment(alignment: TextAlignment): void;
+    insertText(text: string): void;
+    getFlowingText(): string;
+    setFlowingText(text: string): void;
+    /**
+     * Set the cursor position in the active flowing content.
+     * Works for body, header, footer, text boxes, and table cells.
+     */
+    setCursorPosition(position: number): void;
+    /**
+     * Get the current cursor position in the active flowing content.
+     * Returns the position for cursor selections, start position for text selections,
+     * or 0 if no text content is selected.
+     */
+    getCursorPosition(): number;
+    /**
+     * Insert an embedded object at the current cursor position.
+     * Works for body, header, footer, text boxes, and table cells.
+     */
+    insertEmbeddedObject(object: BaseEmbeddedObject, position?: ObjectPosition): void;
+    /**
+     * Insert a substitution field at the current cursor position.
+     * Works for body, header, footer, text boxes, and table cells.
+     */
+    insertSubstitutionField(fieldName: string, config?: SubstitutionFieldConfig): void;
+    /**
+     * Insert a page number field at the current cursor position.
+     * The field displays the current page number during rendering.
+     * Works for body, header, footer, text boxes, and table cells.
+     * @param displayFormat Optional format string (e.g., "Page %d" where %d is replaced by page number)
+     */
+    insertPageNumberField(displayFormat?: string): void;
+    /**
+     * Insert a page count field at the current cursor position.
+     * The field displays the total page count during rendering.
+     * Works for body, header, footer, text boxes, and table cells.
+     * @param displayFormat Optional format string (e.g., "of %d" where %d is replaced by page count)
+     */
+    insertPageCountField(displayFormat?: string): void;
+    /**
+     * Insert a page break at the current cursor position.
+     * Forces subsequent content to start on a new page.
+     * Works for body content. Note: Page breaks in headers, footers, text boxes,
+     * or table cells are not recommended as these don't span pages.
+     */
+    insertPageBreak(): void;
+    /**
+     * Get a substitution field at a specific text position in the active section.
+     * @param position The text index to check
+     * @returns The substitution field at that position, or null if none
+     */
+    getFieldAt(position: number): SubstitutionField | null;
+    /**
+     * Get the substitution field at the current selection/cursor position.
+     * @returns The substitution field if the cursor/selection is on a field, or null
+     */
+    getSelectedField(): SubstitutionField | null;
+    /**
+     * Get the currently selected text box if one is selected.
+     * @returns The selected TextBoxObject or null if no text box is selected
+     */
+    getSelectedTextBox(): TextBoxObject | null;
+    /**
+     * Get the currently selected table if one is selected.
+     * @returns The selected TableObject or null if no table is selected
+     */
+    getSelectedTable(): TableObject | null;
+    /**
+     * Get the currently selected image if one is selected.
+     * @returns The selected ImageObject or null if no image is selected
+     */
+    getSelectedImage(): ImageObject | null;
+    /**
+     * Get the currently focused table (table being edited).
+     * @returns The focused TableObject or null
+     */
+    getFocusedTable(): TableObject | null;
+    /**
+     * Insert a row into a table.
+     * Undo is automatically tracked via ObjectMutationObserver.
+     * @param table The table to modify
+     * @param rowIndex The index at which to insert the row
+     * @param config Optional row configuration
+     */
+    tableInsertRow(table: TableObject, rowIndex: number, config?: TableRowConfig): void;
+    /**
+     * Remove a row from a table.
+     * Undo is automatically tracked via ObjectMutationObserver.
+     * @param table The table to modify
+     * @param rowIndex The index of the row to remove
+     */
+    tableRemoveRow(table: TableObject, rowIndex: number): void;
+    /**
+     * Insert a column into a table.
+     * Undo is automatically tracked via ObjectMutationObserver.
+     * @param table The table to modify
+     * @param colIndex The index at which to insert the column
+     * @param width Optional column width
+     */
+    tableInsertColumn(table: TableObject, colIndex: number, width?: number): void;
+    /**
+     * Remove a column from a table.
+     * Undo is automatically tracked via ObjectMutationObserver.
+     * @param table The table to modify
+     * @param colIndex The index of the column to remove
+     */
+    tableRemoveColumn(table: TableObject, colIndex: number): void;
+    /**
+     * Begin a compound operation. Groups multiple mutations into a single undo entry.
+     * Call endCompoundOperation after making changes.
+     * @param description Description of the change for undo/redo
+     */
+    beginCompoundOperation(description?: string): void;
+    /**
+     * End a compound operation.
+     * @param description Description of the change for undo/redo (overrides begin description)
+     */
+    endCompoundOperation(description?: string): void;
+    /**
+     * Update a substitution field's properties in the active section.
+     * @param textIndex The text index of the field to update
+     * @param updates The properties to update
+     * @returns true if the field was updated, false if not found
+     */
+    updateField(textIndex: number, updates: {
+        fieldName?: string;
+        defaultValue?: string;
+        displayFormat?: string;
+        formatConfig?: import('../text/types').FieldFormatConfig;
+    }): boolean;
+    /**
+     * @deprecated Use insertEmbeddedObject instead
+     */
+    insertInlineElement(_elementData: unknown, _position?: ObjectPosition): void;
+    /**
+     * Apply merge data to substitute all substitution fields with their values.
+     * First expands repeating sections (body only), then replaces fields in body, header, and footer.
+     * Field names can use dot-notation to access nested properties (e.g., "contact.address.street").
+     * For arrays, the 0th element is used by default (e.g., "items.item" resolves to items[0].item).
+     * Fields inside loops resolve relative to their iteration index.
+     * @param data Object containing merge data (can be nested)
+     */
+    applyMergeData(data: Record<string, unknown>): void;
+    /**
+     * Substitute all fields in a FlowingTextContent with values from data.
+     * @returns The number of fields substituted
+     */
+    private substituteFieldsInContent;
+    /**
+     * Substitute all fields in embedded objects (text boxes and tables) within a FlowingTextContent.
+     * @returns The number of fields substituted
+     */
+    private substituteFieldsInEmbeddedObjects;
+    /**
+     * Expand table row loops in embedded tables within a FlowingTextContent.
+     * For each table with row loops, duplicates template rows for each array element.
+     * Must be called before substituteFieldsInEmbeddedObjects().
+     */
+    private expandTableRowLoops;
+    /**
+     * Expand row loops in a single table.
+     * Processes loops from end to start to preserve row indices.
+     */
+    private expandTableRowLoopsInTable;
+    /**
+     * Rewrite field names in a FlowingTextContent to include array index.
+     * Fields that start with fieldPath will have the index inserted.
+     * E.g., "items.name" with fieldPath "items" and index 1 -> "items[1].name"
+     */
+    private rewriteFieldsInContent;
+    /**
+     * Expand repeating sections by duplicating content for each array element.
+     * Processes sections from end to start to preserve text indices.
+     */
+    private expandRepeatingSections;
+    /**
+     * Get a value at a path without array defaulting.
+     * Used to get the array itself rather than its first element.
+     */
+    private getValueAtPath;
+    /**
+     * Rewrite a field name to use an explicit array index.
+     * E.g., if fieldPath is "items" and the field name is "items.name",
+     * this returns "items[index].name".
+     */
+    private rewriteFieldNameWithIndex;
+    /**
+     * Resolve a dot-notation field path to a value in the data object.
+     * Supports nested objects, arrays (default to 0th element), and explicit indices.
+     * @param path Dot-notation path (e.g., "contact.address.street", "items.item", or "items[0].item")
+     * @param data The data object to resolve against
+     * @returns The resolved value or undefined if not found
+     */
+    private resolveFieldPath;
+    /**
+     * Parse a field path into segments, separating dot notation and array indices.
+     * E.g., "items[0].name" -> ["items", "[0]", "name"]
+     * E.g., "items.name" -> ["items", "name"]
+     */
+    private parseFieldPath;
+    applyTextFormatting(start: number, end: number, formatting: any): void;
+    /**
+     * Get the text formatting at a specific position in the active section.
+     * @param position The text index to get formatting at
+     * @returns The formatting style at that position
+     */
+    getFormattingAt(position: number): TextFormattingStyle | null;
+    /**
+     * Get the text formatting for the current selection or cursor position.
+     * Returns the formatting at the start of the selection or at the cursor position.
+     * @returns The formatting style, or null if no text selection/cursor
+     */
+    getSelectionFormatting(): TextFormattingStyle | null;
+    /**
+     * Set the alignment for the paragraph at the current cursor position.
+     * @param alignment The alignment to apply ('left', 'center', 'right', or 'justify')
+     */
+    setAlignment(alignment: TextAlignment): void;
+    /**
+     * Set the alignment for all paragraphs within the current text selection.
+     * If there's no selection, applies to the paragraph at cursor.
+     * @param alignment The alignment to apply ('left', 'center', 'right', or 'justify')
+     */
+    setAlignmentForSelection(alignment: TextAlignment): void;
+    /**
+     * Get the alignment at the current cursor position.
+     * @returns The alignment at cursor, or 'left' as default
+     */
+    getAlignmentAtCursor(): TextAlignment;
+    /**
+     * Toggle bullet list for the current paragraph.
+     */
+    toggleBulletList(): void;
+    /**
+     * Toggle numbered list for the current paragraph.
+     */
+    toggleNumberedList(): void;
+    /**
+     * Indent the current paragraph (increase list nesting level).
+     */
+    indentParagraph(): void;
+    /**
+     * Outdent the current paragraph (decrease list nesting level).
+     */
+    outdentParagraph(): void;
+    /**
+     * Get list formatting for the current paragraph.
+     */
+    getListFormatting(): import('../text').ListFormatting | undefined;
+    /**
+     * Insert a hyperlink for the current selection.
+     * @returns The created hyperlink, or null if no selection
+     */
+    insertHyperlink(url: string, options?: import('../text').HyperlinkOptions): import('../text').Hyperlink | null;
+    /**
+     * Insert a hyperlink at a specific range.
+     */
+    insertHyperlinkAt(url: string, startIndex: number, endIndex: number, options?: import('../text').HyperlinkOptions): import('../text').Hyperlink | null;
+    /**
+     * Remove a hyperlink by ID.
+     */
+    removeHyperlink(id: string): void;
+    /**
+     * Update a hyperlink's properties.
+     */
+    updateHyperlink(id: string, updates: import('../text').HyperlinkUpdate): void;
+    /**
+     * Get the hyperlink at a specific text index.
+     */
+    getHyperlinkAt(textIndex: number): import('../text').Hyperlink | undefined;
+    /**
+     * Get a hyperlink by ID.
+     */
+    getHyperlinkById(id: string): import('../text').Hyperlink | undefined;
+    /**
+     * Get all hyperlinks overlapping a range.
+     */
+    getHyperlinksInRange(startIndex: number, endIndex: number): import('../text').Hyperlink[];
+    /**
+     * Get all hyperlinks.
+     */
+    getAllHyperlinks(): import('../text').Hyperlink[];
+    updateDocumentSettings(settings: Partial<any>): void;
+    getDocumentSettings(): any;
+    /**
+     * Set whether control characters (spaces, tabs, newlines) are shown.
+     * @param show true to show control characters, false to hide
+     */
+    setShowControlCharacters(show: boolean): void;
+    /**
+     * Get whether control characters are currently shown.
+     */
+    getShowControlCharacters(): boolean;
+    /**
+     * Set whether the grid is shown.
+     * @param show true to show the grid, false to hide
+     */
+    setShowGrid(show: boolean): void;
+    /**
+     * Get whether the grid is currently shown.
+     */
+    getShowGrid(): boolean;
+    /**
+     * Set whether margin lines are shown.
+     * @param show true to show margin lines, false to hide
+     */
+    setShowMarginLines(show: boolean): void;
+    /**
+     * Get whether margin lines are currently shown.
+     */
+    getShowMarginLines(): boolean;
+    /**
+     * Get all paragraph boundaries in the body content.
+     * Returns indices that are valid start/end points for repeating sections.
+     * Note: Repeating sections are only supported in the body, not in header/footer.
+     */
+    getParagraphBoundaries(): number[];
+    /**
+     * Create a repeating section in the body content.
+     * Note: Repeating sections are only supported in the body, not in header/footer.
+     * @param startIndex Text index at paragraph start (must be at a paragraph boundary)
+     * @param endIndex Text index at closing paragraph start (must be at a paragraph boundary)
+     * @param fieldPath The field path to the array to loop over (e.g., "items")
+     * @returns The created section, or null if boundaries are invalid
+     */
+    createRepeatingSection(startIndex: number, endIndex: number, fieldPath: string): RepeatingSection | null;
+    /**
+     * Get a repeating section by ID.
+     */
+    getRepeatingSection(id: string): RepeatingSection | null;
+    /**
+     * Get all repeating sections.
+     */
+    getRepeatingSections(): RepeatingSection[];
+    /**
+     * Update a repeating section's field path.
+     */
+    updateRepeatingSectionFieldPath(id: string, fieldPath: string): boolean;
+    /**
+     * Remove a repeating section by ID.
+     */
+    removeRepeatingSection(id: string): boolean;
+    /**
+     * Find a repeating section that has a boundary at the given text index.
+     */
+    getRepeatingSectionAtBoundary(textIndex: number): RepeatingSection | null;
+    /**
+     * Get the header text content.
+     */
+    getHeaderText(): string;
+    /**
+     * Set the header text content.
+     */
+    setHeaderText(text: string): void;
+    /**
+     * Get the footer text content.
+     */
+    getFooterText(): string;
+    /**
+     * Set the footer text content.
+     */
+    setFooterText(text: string): void;
+    /**
+     * Insert a substitution field in the header at the current cursor position.
+     * Temporarily switches to header section, inserts, then restores previous section.
+     */
+    insertHeaderSubstitutionField(fieldName: string, config?: SubstitutionFieldConfig): void;
+    /**
+     * Insert a substitution field in the footer at the current cursor position.
+     * Temporarily switches to footer section, inserts, then restores previous section.
+     */
+    insertFooterSubstitutionField(fieldName: string, config?: SubstitutionFieldConfig): void;
+    /**
+     * Insert an embedded object in the header.
+     */
+    insertHeaderEmbeddedObject(object: BaseEmbeddedObject, position?: ObjectPosition): void;
+    /**
+     * Insert an embedded object in the footer.
+     */
+    insertFooterEmbeddedObject(object: BaseEmbeddedObject, position?: ObjectPosition): void;
+    /**
+     * Copy the current selection to the clipboard.
+     * Returns true if content was copied.
+     */
+    copy(): Promise<boolean>;
+    /**
+     * Cut the current selection to the clipboard (copy + delete).
+     * Returns true if content was cut.
+     */
+    cut(): Promise<boolean>;
+    /**
+     * Paste content from the clipboard at the current cursor position.
+     * Returns true if content was pasted.
+     */
+    paste(): Promise<boolean>;
+    /**
+     * Select all text in the currently focused content.
+     */
+    selectAll(): void;
+    /**
+     * Paste proprietary clipboard content.
+     */
+    private pasteProprietaryContent;
+    /**
+     * Paste clipboard content into FlowingTextContent.
+     */
+    private pasteClipboardContent;
+    /**
+     * Create an embedded object from serialized data.
+     */
+    private createEmbeddedObjectFromData;
+    /**
+     * Paste an image blob as an embedded ImageObject.
+     */
+    private pasteImage;
+    destroy(): void;
+}
+//# sourceMappingURL=PCEditor.d.ts.map