@zeke-02/docx-editor 0.5.1 → 0.5.3

package/dist/agentApi-C41hiW-n.d.mts

@@ -0,0 +1,486 @@
+import React__default, { CSSProperties } from 'react';
+import { T as TextFormatting, P as ParagraphFormatting } from './content-B2MzIMwA.mjs';
+
+/**
+ * Shared FontOption shape + normaliser used by FontPicker components
+ * in both adapters. Lifted from packages/react/src/components/ui/
+ * normalizeFontFamilies.ts so the type definition has a single home.
+ */
+interface FontOption {
+    name: string;
+    fontFamily: string;
+    category?: 'sans-serif' | 'serif' | 'monospace' | 'other';
+}
+
+/**
+ * Print Utilities
+ *
+ * Provides print functionality with:
+ * - Print button component for toolbar
+ * - Print-specific CSS styles
+ * - Browser print dialog trigger
+ * - Page range utilities
+ */
+
+/**
+ * Print options
+ */
+interface PrintOptions {
+    /** Whether to include headers */
+    includeHeaders?: boolean;
+    /** Whether to include footers */
+    includeFooters?: boolean;
+    /** Whether to include page numbers */
+    includePageNumbers?: boolean;
+    /** Page range to print (null = all) */
+    pageRange?: {
+        start: number;
+        end: number;
+    } | null;
+    /** Scale factor for printing (1.0 = 100%) */
+    scale?: number;
+    /** Whether to show background colors */
+    printBackground?: boolean;
+    /** Margins mode */
+    margins?: 'default' | 'none' | 'minimum';
+}
+/**
+ * PrintButton props
+ */
+interface PrintButtonProps {
+    /** Callback when print is triggered */
+    onPrint: () => void;
+    /** Whether the button is disabled */
+    disabled?: boolean;
+    /** Button label */
+    label?: string;
+    /** Additional CSS class */
+    className?: string;
+    /** Additional inline styles */
+    style?: CSSProperties;
+    /** Show icon */
+    showIcon?: boolean;
+    /** Compact mode */
+    compact?: boolean;
+}
+/**
+ * PrintButton - Standalone print button for toolbar
+ */
+declare function PrintButton({ onPrint, disabled, label: labelProp, className, style, showIcon, compact, }: PrintButtonProps): React__default.ReactElement;
+/**
+ * PrintStyles - Injects print-specific CSS
+ */
+declare function PrintStyles(): React__default.ReactElement;
+/**
+ * Trigger browser print dialog for the current document
+ */
+declare function triggerPrint(): void;
+/**
+ * Create print-optimized document view in a new window
+ */
+declare function openPrintWindow(title: string | undefined, content: string): Window | null;
+/**
+ * Get default print options
+ */
+declare function getDefaultPrintOptions(): PrintOptions;
+/**
+ * Create page range from string (e.g., "1-5", "3", "1,3,5")
+ */
+declare function parsePageRange(input: string, maxPages: number): {
+    start: number;
+    end: number;
+} | null;
+/**
+ * Format page range for display
+ */
+declare function formatPageRange(range: {
+    start: number;
+    end: number;
+} | null, totalPages: number): string;
+/**
+ * Check if browser supports good print functionality
+ */
+declare function isPrintSupported(): boolean;
+
+/**
+ * Agent API Types
+ *
+ * TypeScript interfaces for the agent API:
+ * - Position and Range types
+ * - Command types for document manipulation
+ * - Context types for AI agents
+ */
+
+/**
+ * Position within a document
+ */
+interface Position {
+    /** Index of the paragraph (0-indexed) */
+    paragraphIndex: number;
+    /** Offset within the paragraph in characters */
+    offset: number;
+    /** Optional: Content index within paragraph (run, hyperlink, etc.) */
+    contentIndex?: number;
+    /** Optional: Section index */
+    sectionIndex?: number;
+}
+/**
+ * Range within a document
+ */
+interface Range {
+    /** Start position */
+    start: Position;
+    /** End position */
+    end: Position;
+    /** Whether the range is collapsed (cursor position) */
+    collapsed?: boolean;
+}
+/**
+ * Base command interface
+ */
+interface BaseCommand {
+    /** Command type */
+    type: string;
+    /** Unique command ID (for undo tracking) */
+    id?: string;
+}
+/**
+ * Insert text at a position
+ */
+interface InsertTextCommand extends BaseCommand {
+    type: 'insertText';
+    /** Position to insert at */
+    position: Position;
+    /** Text to insert */
+    text: string;
+    /** Optional formatting for the inserted text */
+    formatting?: TextFormatting;
+}
+/**
+ * Replace text in a range
+ */
+interface ReplaceTextCommand extends BaseCommand {
+    type: 'replaceText';
+    /** Range to replace */
+    range: Range;
+    /** Replacement text */
+    text: string;
+    /** Optional formatting for the new text */
+    formatting?: TextFormatting;
+}
+/**
+ * Delete text in a range
+ */
+interface DeleteTextCommand extends BaseCommand {
+    type: 'deleteText';
+    /** Range to delete */
+    range: Range;
+}
+/**
+ * Apply formatting to a range
+ */
+interface FormatTextCommand extends BaseCommand {
+    type: 'formatText';
+    /** Range to format */
+    range: Range;
+    /** Formatting to apply */
+    formatting: Partial<TextFormatting>;
+}
+/**
+ * Apply paragraph formatting
+ */
+interface FormatParagraphCommand extends BaseCommand {
+    type: 'formatParagraph';
+    /** Paragraph index */
+    paragraphIndex: number;
+    /** Formatting to apply */
+    formatting: Partial<ParagraphFormatting>;
+}
+/**
+ * Apply a named style to a paragraph
+ */
+interface ApplyStyleCommand extends BaseCommand {
+    type: 'applyStyle';
+    /** Paragraph index */
+    paragraphIndex: number;
+    /** Style ID to apply */
+    styleId: string;
+}
+/**
+ * Insert a table at a position
+ */
+interface InsertTableCommand extends BaseCommand {
+    type: 'insertTable';
+    /** Position to insert at */
+    position: Position;
+    /** Number of rows */
+    rows: number;
+    /** Number of columns */
+    columns: number;
+    /** Optional table data */
+    data?: string[][];
+    /** Optional header row */
+    hasHeader?: boolean;
+}
+/**
+ * Insert an image at a position
+ */
+interface InsertImageCommand extends BaseCommand {
+    type: 'insertImage';
+    /** Position to insert at */
+    position: Position;
+    /** Image source (base64 or URL) */
+    src: string;
+    /** Image width in pixels */
+    width?: number;
+    /** Image height in pixels */
+    height?: number;
+    /** Alt text */
+    alt?: string;
+}
+/**
+ * Insert a hyperlink at a range
+ */
+interface InsertHyperlinkCommand extends BaseCommand {
+    type: 'insertHyperlink';
+    /** Range to make into a hyperlink */
+    range: Range;
+    /** URL of the hyperlink */
+    url: string;
+    /** Display text (replaces range text if provided) */
+    displayText?: string;
+    /** Tooltip */
+    tooltip?: string;
+}
+/**
+ * Remove a hyperlink but keep the text
+ */
+interface RemoveHyperlinkCommand extends BaseCommand {
+    type: 'removeHyperlink';
+    /** Range containing the hyperlink */
+    range: Range;
+}
+/**
+ * Insert a paragraph break
+ */
+interface InsertParagraphBreakCommand extends BaseCommand {
+    type: 'insertParagraphBreak';
+    /** Position to break at */
+    position: Position;
+}
+/**
+ * Merge paragraphs
+ */
+interface MergeParagraphsCommand extends BaseCommand {
+    type: 'mergeParagraphs';
+    /** First paragraph index */
+    paragraphIndex: number;
+    /** Number of paragraphs to merge with */
+    count: number;
+}
+/**
+ * Split a paragraph
+ */
+interface SplitParagraphCommand extends BaseCommand {
+    type: 'splitParagraph';
+    /** Position to split at */
+    position: Position;
+}
+/**
+ * Set template variable value
+ */
+interface SetVariableCommand extends BaseCommand {
+    type: 'setVariable';
+    /** Variable name */
+    name: string;
+    /** Variable value */
+    value: string;
+}
+/**
+ * Apply all template variables
+ */
+interface ApplyVariablesCommand extends BaseCommand {
+    type: 'applyVariables';
+    /** Variable values */
+    values: Record<string, string>;
+}
+/**
+ * Union of all command types
+ */
+type AgentCommand = InsertTextCommand | ReplaceTextCommand | DeleteTextCommand | FormatTextCommand | FormatParagraphCommand | ApplyStyleCommand | InsertTableCommand | InsertImageCommand | InsertHyperlinkCommand | RemoveHyperlinkCommand | InsertParagraphBreakCommand | MergeParagraphsCommand | SplitParagraphCommand | SetVariableCommand | ApplyVariablesCommand;
+/**
+ * Document context for AI agents
+ */
+interface AgentContext {
+    /** Total paragraph count */
+    paragraphCount: number;
+    /** Total word count (approximate) */
+    wordCount: number;
+    /** Total character count */
+    characterCount: number;
+    /** Detected template variables */
+    variables: string[];
+    /** Variable count */
+    variableCount: number;
+    /** Available styles */
+    availableStyles: StyleInfo[];
+    /** Content outline (first N chars per paragraph) */
+    outline: ParagraphOutline[];
+    /** Document sections info */
+    sections: SectionInfo[];
+    /** Has tables */
+    hasTables: boolean;
+    /** Has images */
+    hasImages: boolean;
+    /** Has hyperlinks */
+    hasHyperlinks: boolean;
+    /** Document language */
+    language?: string;
+}
+/**
+ * Style information for context
+ */
+interface StyleInfo {
+    /** Style ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Style type */
+    type: 'paragraph' | 'character' | 'table';
+    /** Is built-in style */
+    builtIn?: boolean;
+}
+/**
+ * Paragraph outline for context
+ */
+interface ParagraphOutline {
+    /** Paragraph index */
+    index: number;
+    /** First N characters */
+    preview: string;
+    /** Paragraph style */
+    style?: string;
+    /** Is heading */
+    isHeading?: boolean;
+    /** Heading level (1-9) */
+    headingLevel?: number;
+    /** Is list item */
+    isListItem?: boolean;
+    /** Is empty paragraph */
+    isEmpty?: boolean;
+}
+/**
+ * Section information
+ */
+interface SectionInfo {
+    /** Section index */
+    index: number;
+    /** Number of paragraphs */
+    paragraphCount: number;
+    /** Page size */
+    pageSize?: {
+        width: number;
+        height: number;
+    };
+    /** Is landscape */
+    isLandscape?: boolean;
+    /** Has header */
+    hasHeader?: boolean;
+    /** Has footer */
+    hasFooter?: boolean;
+}
+/**
+ * Context about the current selection
+ */
+interface SelectionContext {
+    /** Selected text */
+    selectedText: string;
+    /** Selection range */
+    range: Range;
+    /** Current formatting of selection */
+    formatting: Partial<TextFormatting>;
+    /** Current paragraph formatting */
+    paragraphFormatting: Partial<ParagraphFormatting>;
+    /** Text before selection (context) */
+    textBefore: string;
+    /** Text after selection (context) */
+    textAfter: string;
+    /** Paragraph containing selection */
+    paragraph: ParagraphContext;
+    /** Is selection within a table */
+    inTable?: boolean;
+    /** Is selection within a hyperlink */
+    inHyperlink?: boolean;
+    /** Suggested actions based on selection */
+    suggestedActions?: SuggestedAction[];
+}
+/**
+ * Paragraph context for selection
+ */
+interface ParagraphContext {
+    /** Paragraph index */
+    index: number;
+    /** Full paragraph text */
+    fullText: string;
+    /** Paragraph style */
+    style?: string;
+    /** Word count */
+    wordCount: number;
+}
+/**
+ * Suggested action for context menu
+ */
+interface SuggestedAction {
+    /** Action ID */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Description */
+    description?: string;
+    /** Icon name */
+    icon?: string;
+    /** Priority (higher = more prominent) */
+    priority?: number;
+}
+/**
+ * Response from an agent action
+ */
+interface AgentResponse {
+    /** Success status */
+    success: boolean;
+    /** New text to insert (for rewrite/expand/etc.) */
+    newText?: string;
+    /** New formatted content */
+    newContent?: AgentContent[];
+    /** Commands to execute */
+    commands?: AgentCommand[];
+    /** Error message if failed */
+    error?: string;
+    /** Warning messages */
+    warnings?: string[];
+    /** Metadata about the response */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Content block in agent response
+ */
+interface AgentContent {
+    /** Content type */
+    type: 'text' | 'paragraph' | 'table' | 'image';
+    /** Text content */
+    text?: string;
+    /** Formatting */
+    formatting?: Partial<TextFormatting>;
+    /** Paragraph formatting */
+    paragraphFormatting?: Partial<ParagraphFormatting>;
+    /** Table data (for table type) */
+    tableData?: string[][];
+    /** Image src (for image type) */
+    imageSrc?: string;
+}
+/**
+ * AI action types for context menu
+ */
+type AIAction = 'askAI' | 'rewrite' | 'expand' | 'summarize' | 'translate' | 'explain' | 'fixGrammar' | 'makeFormal' | 'makeCasual' | 'custom';
+
+export { type AgentContext as A, type FontOption as F, type Position as P, type Range as R, type StyleInfo as S, type AgentCommand as a, type PrintOptions as b, type SelectionContext as c, type AIAction as d, type AgentResponse as e, PrintButton as f, type PrintButtonProps as g, PrintStyles as h, formatPageRange as i, getDefaultPrintOptions as j, isPrintSupported as k, openPrintWindow as o, parsePageRange as p, triggerPrint as t };