@nice2dev/ui-tools 1.0.10

package/dist/word-processor.d.ts

@@ -0,0 +1,1124 @@
+/**
+ * @file word-processor.ts
+ * @module @nice2dev/ui-tools
+ * @description PRO-14.3 — Word Processor
+ *
+ * Types for Word-like document editor: rich text, styles, tables, images,
+ * lists, headers/footers, track changes, comments, mail merge, templates.
+ */
+/** Document node type */
+export type DocumentNodeType = 'document' | 'paragraph' | 'text' | 'heading' | 'table' | 'tableRow' | 'tableCell' | 'image' | 'list' | 'listItem' | 'blockquote' | 'codeBlock' | 'horizontalRule' | 'pageBreak' | 'sectionBreak' | 'columnBreak' | 'bookmark' | 'hyperlink' | 'footnote' | 'endnote' | 'comment' | 'toc' | 'field' | 'drawing' | 'shape' | 'equation' | 'embed';
+/** Text alignment */
+export type TextAlignment = 'left' | 'center' | 'right' | 'justify' | 'distributed';
+/** Vertical alignment */
+export type VerticalAlignment = 'top' | 'center' | 'bottom';
+/** Document editor configuration */
+export interface DocumentEditorConfig {
+    /** Initial content */
+    content?: DocumentContent;
+    /** Document template */
+    template?: DocumentTemplate;
+    /** Page setup */
+    pageSetup?: PageSetup;
+    /** Enable spell check */
+    spellCheck?: boolean;
+    /** Enable grammar check */
+    grammarCheck?: boolean;
+    /** Enable auto-correct */
+    autoCorrect?: boolean;
+    /** Enable auto-format */
+    autoFormat?: boolean;
+    /** Enable track changes */
+    trackChanges?: boolean;
+    /** Enable comments */
+    comments?: boolean;
+    /** Enable collaboration */
+    collaboration?: boolean;
+    /** Enable undo/redo */
+    undoRedo?: boolean;
+    /** Max undo steps */
+    maxUndoSteps?: number;
+    /** Read only */
+    readOnly?: boolean;
+    /** Show rulers */
+    showRulers?: boolean;
+    /** Show page breaks */
+    showPageBreaks?: boolean;
+    /** Show formatting marks */
+    showFormattingMarks?: boolean;
+    /** Show navigation pane */
+    showNavigationPane?: boolean;
+    /** View mode */
+    viewMode?: ViewMode;
+    /** Zoom level */
+    zoom?: number;
+    /** Language */
+    language?: string;
+    /** Custom styles */
+    customStyles?: DocumentStyle[];
+    /** Custom fonts */
+    customFonts?: {
+        family: string;
+        url: string;
+    }[];
+    /** Toolbar configuration */
+    toolbar?: DocumentToolbarConfig;
+    /** Mention configuration */
+    mentions?: MentionConfig;
+}
+/** View mode */
+export type ViewMode = 'print' | 'web' | 'outline' | 'draft' | 'read';
+/** Page setup */
+export interface PageSetup {
+    size?: PageSize;
+    customSize?: {
+        width: number;
+        height: number;
+    };
+    orientation?: 'portrait' | 'landscape';
+    margins?: PageMargins;
+    gutter?: number;
+    gutterPosition?: 'left' | 'top';
+    mirrorMargins?: boolean;
+    header?: number;
+    footer?: number;
+    paperSource?: {
+        first?: string;
+        other?: string;
+    };
+    lineNumbers?: LineNumberConfig;
+    columns?: ColumnConfig;
+    verticalAlign?: VerticalAlignment;
+}
+/** Page size */
+export type PageSize = 'letter' | 'legal' | 'tabloid' | 'ledger' | 'a3' | 'a4' | 'a5' | 'b4' | 'b5' | 'executive' | 'custom';
+/** Page margins */
+export interface PageMargins {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/** Line number configuration */
+export interface LineNumberConfig {
+    enabled: boolean;
+    startAt?: number;
+    countBy?: number;
+    restartMode?: 'continuous' | 'page' | 'section';
+    distance?: number;
+}
+/** Column configuration */
+export interface ColumnConfig {
+    count: number;
+    spacing?: number;
+    widths?: number[];
+    separatorLine?: boolean;
+}
+/** Mention configuration */
+export interface MentionConfig {
+    trigger?: string;
+    users?: MentionUser[];
+    fetchUsers?: (query: string) => Promise<MentionUser[]>;
+}
+/** Mention user */
+export interface MentionUser {
+    id: string;
+    name: string;
+    avatar?: string;
+    email?: string;
+}
+/** Document toolbar configuration */
+export interface DocumentToolbarConfig {
+    visible?: boolean;
+    position?: 'top' | 'floating';
+    items?: DocumentToolbarItem[];
+    customItems?: DocumentCustomToolbarItem[];
+}
+/** Toolbar item */
+export type DocumentToolbarItem = 'undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'pasteSpecial' | 'font' | 'fontSize' | 'fontSizeIncrease' | 'fontSizeDecrease' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'subscript' | 'superscript' | 'textColor' | 'highlight' | 'clearFormatting' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'lineSpacing' | 'bulletList' | 'numberedList' | 'decreaseIndent' | 'increaseIndent' | 'insertTable' | 'insertImage' | 'insertLink' | 'insertComment' | 'insertPageBreak' | 'insertSymbol' | 'insertEquation' | 'insertToc' | 'styles' | 'find' | 'replace' | 'spellCheck' | 'trackChanges' | 'print' | 'separator';
+/** Custom toolbar item */
+export interface DocumentCustomToolbarItem {
+    id: string;
+    label?: string;
+    icon?: string;
+    tooltip?: string;
+    handler: () => void;
+    disabled?: boolean;
+    position?: number;
+}
+/** Document content */
+export interface DocumentContent {
+    type: 'document';
+    content: DocumentNode[];
+    properties?: DocumentProperties;
+}
+/** Document node */
+export type DocumentNode = ParagraphNode | HeadingNode | TableNode | ImageNode | ListNode | BlockquoteNode | CodeBlockNode | HorizontalRuleNode | PageBreakNode | SectionBreakNode | TocNode | DrawingNode | EquationNode | EmbedNode;
+/** Text node */
+export interface TextNode {
+    type: 'text';
+    text: string;
+    marks?: TextMark[];
+}
+/** Text mark */
+export interface TextMark {
+    type: MarkType;
+    attrs?: Record<string, unknown>;
+}
+/** Mark type */
+export type MarkType = 'bold' | 'italic' | 'underline' | 'strikethrough' | 'subscript' | 'superscript' | 'code' | 'link' | 'textStyle' | 'highlight' | 'comment' | 'footnoteRef' | 'bookmarkRef';
+/** Paragraph node */
+export interface ParagraphNode {
+    type: 'paragraph';
+    content?: (TextNode | InlineNode)[];
+    attrs?: ParagraphAttrs;
+}
+/** Paragraph attributes */
+export interface ParagraphAttrs {
+    alignment?: TextAlignment;
+    lineSpacing?: number | LineSpacing;
+    spaceBefore?: number;
+    spaceAfter?: number;
+    firstLineIndent?: number;
+    leftIndent?: number;
+    rightIndent?: number;
+    styleId?: string;
+    keepWithNext?: boolean;
+    keepTogether?: boolean;
+    pageBreakBefore?: boolean;
+    widowOrphanControl?: boolean;
+    borderTop?: BorderDef;
+    borderBottom?: BorderDef;
+    borderLeft?: BorderDef;
+    borderRight?: BorderDef;
+    shading?: ShadingDef;
+    tabStops?: TabStop[];
+}
+/** Line spacing */
+export interface LineSpacing {
+    rule: 'auto' | 'exact' | 'atLeast' | 'multiple';
+    value: number;
+}
+/** Border definition */
+export interface BorderDef {
+    style: BorderStyle;
+    width: number;
+    color: string;
+    space?: number;
+}
+/** Border style */
+export type BorderStyle = 'single' | 'thick' | 'double' | 'dotted' | 'dashed' | 'dashSmallGap' | 'dotDash' | 'dotDotDash' | 'triple' | 'thinThickSmallGap' | 'thickThinSmallGap' | 'thinThickThinSmallGap' | 'thinThickMediumGap' | 'thickThinMediumGap' | 'thinThickThinMediumGap' | 'thinThickLargeGap' | 'thickThinLargeGap' | 'thinThickThinLargeGap' | 'wave' | 'doubleWave' | 'dashDotStroked' | 'threeDEmboss' | 'threeDEngrave' | 'outset' | 'inset' | 'none';
+/** Shading definition */
+export interface ShadingDef {
+    pattern: ShadingPattern;
+    color?: string;
+    fill?: string;
+}
+/** Shading pattern */
+export type ShadingPattern = 'clear' | 'solid' | 'horzStripe' | 'vertStripe' | 'diagStripe' | 'reverseDiagStripe' | 'horzCross' | 'diagCross' | 'thinHorzStripe' | 'thinVertStripe' | 'thinDiagStripe' | 'thinReverseDiagStripe' | 'thinHorzCross' | 'thinDiagCross' | 'pct5' | 'pct10' | 'pct12' | 'pct15' | 'pct20' | 'pct25' | 'pct30' | 'pct35' | 'pct37' | 'pct40' | 'pct45' | 'pct50' | 'pct55' | 'pct60' | 'pct62' | 'pct65' | 'pct70' | 'pct75' | 'pct80' | 'pct85' | 'pct87' | 'pct90' | 'pct95';
+/** Tab stop */
+export interface TabStop {
+    position: number;
+    alignment: 'left' | 'center' | 'right' | 'decimal' | 'bar';
+    leader?: 'none' | 'dot' | 'hyphen' | 'underscore' | 'middleDot';
+}
+/** Inline node */
+export type InlineNode = TextNode | InlineImageNode | HyperlinkNode | BookmarkNode | FootnoteRefNode | EndnoteRefNode | FieldNode | SymbolNode | InlineEquationNode;
+/** Heading node */
+export interface HeadingNode {
+    type: 'heading';
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    content?: (TextNode | InlineNode)[];
+    attrs?: HeadingAttrs;
+}
+/** Heading attributes */
+export interface HeadingAttrs extends ParagraphAttrs {
+    outlineLevel?: number;
+    numbering?: HeadingNumbering;
+}
+/** Heading numbering */
+export interface HeadingNumbering {
+    format: NumberingFormat;
+    prefix?: string;
+    suffix?: string;
+    start?: number;
+}
+/** Numbering format */
+export type NumberingFormat = 'decimal' | 'lowerLetter' | 'upperLetter' | 'lowerRoman' | 'upperRoman' | 'bullet' | 'ordinal' | 'cardinalText' | 'ordinalText' | 'hex' | 'chicago' | 'decimalZero' | 'none';
+/** Table node */
+export interface TableNode {
+    type: 'table';
+    rows: TableRowNode[];
+    attrs?: TableAttrs;
+}
+/** Table attributes */
+export interface TableAttrs {
+    width?: TableWidth;
+    alignment?: TextAlignment;
+    indent?: number;
+    borders?: TableBorders;
+    shading?: ShadingDef;
+    cellMargins?: CellMargins;
+    cellSpacing?: number;
+    layout?: 'auto' | 'fixed';
+    look?: TableLook;
+    caption?: string;
+}
+/** Table width */
+export interface TableWidth {
+    type: 'auto' | 'dxa' | 'pct';
+    value: number;
+}
+/** Table borders */
+export interface TableBorders {
+    top?: BorderDef;
+    bottom?: BorderDef;
+    left?: BorderDef;
+    right?: BorderDef;
+    insideH?: BorderDef;
+    insideV?: BorderDef;
+}
+/** Cell margins */
+export interface CellMargins {
+    top?: number;
+    bottom?: number;
+    left?: number;
+    right?: number;
+}
+/** Table look */
+export interface TableLook {
+    firstRow?: boolean;
+    lastRow?: boolean;
+    firstColumn?: boolean;
+    lastColumn?: boolean;
+    noHBand?: boolean;
+    noVBand?: boolean;
+}
+/** Table row node */
+export interface TableRowNode {
+    type: 'tableRow';
+    cells: TableCellNode[];
+    attrs?: TableRowAttrs;
+}
+/** Table row attributes */
+export interface TableRowAttrs {
+    height?: TableRowHeight;
+    header?: boolean;
+    cantSplit?: boolean;
+}
+/** Table row height */
+export interface TableRowHeight {
+    rule: 'auto' | 'exact' | 'atLeast';
+    value: number;
+}
+/** Table cell node */
+export interface TableCellNode {
+    type: 'tableCell';
+    content: (ParagraphNode | TableNode | ListNode | ImageNode)[];
+    attrs?: TableCellAttrs;
+}
+/** Table cell attributes */
+export interface TableCellAttrs {
+    width?: TableWidth;
+    colspan?: number;
+    rowspan?: number;
+    verticalAlign?: VerticalAlignment;
+    textDirection?: 'lrTb' | 'tbRl' | 'btLr' | 'lrTbV' | 'tbRlV' | 'tbLrV';
+    borders?: TableBorders;
+    shading?: ShadingDef;
+    margins?: CellMargins;
+    noWrap?: boolean;
+    fitText?: boolean;
+}
+/** Image node */
+export interface ImageNode {
+    type: 'image';
+    src: string;
+    attrs?: ImageAttrs;
+}
+/** Image attributes */
+export interface ImageAttrs {
+    alt?: string;
+    title?: string;
+    width?: number;
+    height?: number;
+    alignment?: TextAlignment;
+    wrapping?: ImageWrapping;
+    position?: ImagePosition;
+    border?: BorderDef;
+    effects?: ImageEffects;
+}
+/** Image wrapping */
+export interface ImageWrapping {
+    type: 'inline' | 'square' | 'tight' | 'through' | 'topBottom' | 'behind' | 'inFront';
+    side?: 'both' | 'left' | 'right' | 'largest';
+    distanceTop?: number;
+    distanceBottom?: number;
+    distanceLeft?: number;
+    distanceRight?: number;
+}
+/** Image position */
+export interface ImagePosition {
+    horizontal?: PositionDef;
+    vertical?: PositionDef;
+    allowOverlap?: boolean;
+    locked?: boolean;
+    layoutInCell?: boolean;
+}
+/** Position definition */
+export interface PositionDef {
+    relative: 'character' | 'column' | 'margin' | 'page' | 'paragraph' | 'line';
+    align?: 'left' | 'center' | 'right' | 'inside' | 'outside';
+    offset?: number;
+}
+/** Image effects */
+export interface ImageEffects {
+    brightness?: number;
+    contrast?: number;
+    saturation?: number;
+    rotation?: number;
+    flipH?: boolean;
+    flipV?: boolean;
+    crop?: CropDef;
+    shadow?: ShadowDef;
+    reflection?: ReflectionDef;
+    glow?: GlowDef;
+    softEdge?: number;
+}
+/** Crop definition */
+export interface CropDef {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+/** Shadow definition */
+export interface ShadowDef {
+    type: 'outer' | 'inner';
+    color: string;
+    blur: number;
+    distance: number;
+    direction: number;
+    opacity?: number;
+}
+/** Reflection definition */
+export interface ReflectionDef {
+    blur: number;
+    startOpacity: number;
+    endOpacity: number;
+    startPosition: number;
+    endPosition: number;
+    distance: number;
+    direction: number;
+}
+/** Glow definition */
+export interface GlowDef {
+    color: string;
+    radius: number;
+    opacity?: number;
+}
+/** Inline image node */
+export interface InlineImageNode {
+    type: 'inlineImage';
+    src: string;
+    attrs?: {
+        alt?: string;
+        width?: number;
+        height?: number;
+    };
+}
+/** Drawing node */
+export interface DrawingNode {
+    type: 'drawing';
+    shapes: ShapeNode[];
+    attrs?: DrawingAttrs;
+}
+/** Drawing attributes */
+export interface DrawingAttrs extends ImageAttrs {
+    groupId?: string;
+}
+/** Shape node */
+export interface ShapeNode {
+    type: 'shape';
+    shapeType: ShapeType;
+    position: {
+        x: number;
+        y: number;
+    };
+    size: {
+        width: number;
+        height: number;
+    };
+    attrs?: ShapeAttrs;
+    textContent?: ParagraphNode[];
+}
+/** Shape type */
+export type ShapeType = 'rectangle' | 'roundedRectangle' | 'ellipse' | 'triangle' | 'rightTriangle' | 'parallelogram' | 'trapezoid' | 'diamond' | 'pentagon' | 'hexagon' | 'heptagon' | 'octagon' | 'star4' | 'star5' | 'star6' | 'star7' | 'star8' | 'star10' | 'star12' | 'star16' | 'star24' | 'star32' | 'lineArrow' | 'lineArrowDouble' | 'line' | 'curvedConnector' | 'connector' | 'callout1' | 'callout2' | 'callout3' | 'wedgeRoundRectCallout' | 'wedgeEllipseCallout' | 'cloudCallout' | 'borderCallout1' | 'borderCallout2' | 'borderCallout3' | 'cube' | 'cylinder' | 'donut' | 'can' | 'blockArc' | 'heart' | 'lightningBolt' | 'sun' | 'moon' | 'cloud' | 'brace' | 'bracket' | 'flowchartProcess' | 'flowchartDecision' | 'flowchartData' | 'flowchartTerminator' | 'flowchartDocument';
+/** Shape attributes */
+export interface ShapeAttrs {
+    fill?: ShapeFill;
+    stroke?: ShapeStroke;
+    rotation?: number;
+    flipH?: boolean;
+    flipV?: boolean;
+    shadow?: ShadowDef;
+    opacity?: number;
+}
+/** Shape fill */
+export interface ShapeFill {
+    type: 'solid' | 'gradient' | 'pattern' | 'none';
+    color?: string;
+    gradient?: GradientFill;
+    pattern?: PatternFill;
+}
+/** Gradient fill */
+export interface GradientFill {
+    type: 'linear' | 'radial';
+    angle?: number;
+    stops: {
+        position: number;
+        color: string;
+    }[];
+}
+/** Pattern fill */
+export interface PatternFill {
+    pattern: string;
+    foreground: string;
+    background: string;
+}
+/** Shape stroke */
+export interface ShapeStroke {
+    color: string;
+    width: number;
+    style?: 'solid' | 'dashed' | 'dotted' | 'dashDot' | 'dashDotDot';
+    dashArray?: number[];
+    cap?: 'flat' | 'round' | 'square';
+    join?: 'miter' | 'round' | 'bevel';
+}
+/** List node */
+export interface ListNode {
+    type: 'list';
+    listType: 'bullet' | 'ordered';
+    items: ListItemNode[];
+    attrs?: ListAttrs;
+}
+/** List attributes */
+export interface ListAttrs {
+    styleId?: string;
+    start?: number;
+    tight?: boolean;
+}
+/** List item node */
+export interface ListItemNode {
+    type: 'listItem';
+    content: (ParagraphNode | ListNode)[];
+    attrs?: ListItemAttrs;
+}
+/** List item attributes */
+export interface ListItemAttrs {
+    level?: number;
+    numbering?: ListNumbering;
+}
+/** List numbering */
+export interface ListNumbering {
+    format: NumberingFormat;
+    text?: string;
+    font?: string;
+    color?: string;
+    size?: number;
+}
+/** Blockquote node */
+export interface BlockquoteNode {
+    type: 'blockquote';
+    content: (ParagraphNode | ListNode | BlockquoteNode)[];
+    attrs?: {
+        alignment?: TextAlignment;
+        borderLeft?: BorderDef;
+        shading?: ShadingDef;
+    };
+}
+/** Code block node */
+export interface CodeBlockNode {
+    type: 'codeBlock';
+    content: string;
+    attrs?: {
+        language?: string;
+        lineNumbers?: boolean;
+        theme?: string;
+    };
+}
+/** Horizontal rule node */
+export interface HorizontalRuleNode {
+    type: 'horizontalRule';
+    attrs?: {
+        width?: string | number;
+        height?: number;
+        alignment?: TextAlignment;
+        color?: string;
+        style?: 'single' | 'double' | 'dotted' | 'dashed' | 'thick';
+        noShade?: boolean;
+    };
+}
+/** Page break node */
+export interface PageBreakNode {
+    type: 'pageBreak';
+}
+/** Section break node */
+export interface SectionBreakNode {
+    type: 'sectionBreak';
+    breakType: 'nextPage' | 'continuous' | 'evenPage' | 'oddPage';
+    attrs?: {
+        pageSetup?: PageSetup;
+        headerFooter?: SectionHeaderFooter;
+    };
+}
+/** Section header/footer */
+export interface SectionHeaderFooter {
+    differentFirst?: boolean;
+    differentOddEven?: boolean;
+    header?: HeaderFooterContent;
+    headerFirst?: HeaderFooterContent;
+    headerEven?: HeaderFooterContent;
+    footer?: HeaderFooterContent;
+    footerFirst?: HeaderFooterContent;
+    footerEven?: HeaderFooterContent;
+}
+/** Header/footer content */
+export interface HeaderFooterContent {
+    content: (ParagraphNode | TableNode | ImageNode)[];
+}
+/** TOC node */
+export interface TocNode {
+    type: 'toc';
+    attrs?: TocAttrs;
+}
+/** TOC attributes */
+export interface TocAttrs {
+    title?: string;
+    levels?: number;
+    showPageNumbers?: boolean;
+    rightAlignPageNumbers?: boolean;
+    useHyperlinks?: boolean;
+    leader?: 'none' | 'dot' | 'hyphen' | 'underscore';
+    includeHeadings?: boolean;
+    includeTocEntryStyles?: string[];
+    preserveFormatting?: boolean;
+}
+/** Equation node */
+export interface EquationNode {
+    type: 'equation';
+    latex: string;
+    attrs?: {
+        displayMode?: boolean;
+        alignment?: TextAlignment;
+    };
+}
+/** Inline equation node */
+export interface InlineEquationNode {
+    type: 'inlineEquation';
+    latex: string;
+}
+/** Embed node */
+export interface EmbedNode {
+    type: 'embed';
+    embedType: 'video' | 'audio' | 'iframe' | 'object';
+    src: string;
+    attrs?: {
+        width?: number;
+        height?: number;
+        poster?: string;
+        autoplay?: boolean;
+        controls?: boolean;
+        loop?: boolean;
+    };
+}
+/** Hyperlink node */
+export interface HyperlinkNode {
+    type: 'hyperlink';
+    href: string;
+    content: (TextNode | InlineImageNode)[];
+    attrs?: {
+        target?: '_blank' | '_self' | '_parent' | '_top';
+        tooltip?: string;
+        bookmark?: string;
+    };
+}
+/** Bookmark node */
+export interface BookmarkNode {
+    type: 'bookmark';
+    id: string;
+    name: string;
+}
+/** Footnote reference node */
+export interface FootnoteRefNode {
+    type: 'footnoteRef';
+    footnoteId: string;
+}
+/** Endnote reference node */
+export interface EndnoteRefNode {
+    type: 'endnoteRef';
+    endnoteId: string;
+}
+/** Field node */
+export interface FieldNode {
+    type: 'field';
+    fieldType: FieldType;
+    code?: string;
+    attrs?: Record<string, unknown>;
+}
+/** Field type */
+export type FieldType = 'page' | 'numPages' | 'date' | 'time' | 'author' | 'title' | 'subject' | 'fileName' | 'fileSize' | 'createDate' | 'saveDate' | 'printDate' | 'editTime' | 'revNum' | 'docProperty' | 'seq' | 'ref' | 'pageRef' | 'noteRef' | 'mergeField' | 'if' | 'formula' | 'hyperlink' | 'toc' | 'tocEntry' | 'index' | 'xe' | 'ta' | 'tc' | 'custom';
+/** Symbol node */
+export interface SymbolNode {
+    type: 'symbol';
+    char: string;
+    attrs?: {
+        font?: string;
+        size?: number;
+    };
+}
+/** Document properties */
+export interface DocumentProperties {
+    title?: string;
+    subject?: string;
+    author?: string;
+    keywords?: string[];
+    description?: string;
+    category?: string;
+    comments?: string;
+    status?: string;
+    created?: Date;
+    modified?: Date;
+    lastModifiedBy?: string;
+    revision?: number;
+    version?: string;
+    language?: string;
+    customProperties?: Record<string, unknown>;
+    compatibility?: CompatibilitySettings;
+    protection?: DocumentProtection;
+    variables?: Record<string, string>;
+}
+/** Compatibility settings */
+export interface CompatibilitySettings {
+    compatibilityMode?: 'word2007' | 'word2010' | 'word2013' | 'word2016' | 'word2019';
+    useWord2002TableStyleRules?: boolean;
+    growAutofit?: boolean;
+    useFELayout?: boolean;
+    useNormalStyleForList?: boolean;
+    doNotUseIndentAsNumberingTabStop?: boolean;
+    useAltKinsokuLineBreakRules?: boolean;
+    allowSpaceOfSameStyleInTable?: boolean;
+}
+/** Document protection */
+export interface DocumentProtection {
+    type: 'none' | 'readOnly' | 'comments' | 'trackedChanges' | 'forms';
+    password?: string;
+    formatting?: boolean;
+    enforcementAlgorithm?: string;
+}
+/** Document style */
+export interface DocumentStyle {
+    id: string;
+    name: string;
+    type: 'paragraph' | 'character' | 'table' | 'numbering';
+    basedOn?: string;
+    nextStyle?: string;
+    linkedStyle?: string;
+    uiPriority?: number;
+    unhideWhenUsed?: boolean;
+    semiHidden?: boolean;
+    qFormat?: boolean;
+    paragraphProperties?: ParagraphAttrs;
+    characterProperties?: CharacterProperties;
+    tableProperties?: TableStyleProperties;
+    numberingProperties?: NumberingStyleProperties;
+}
+/** Character properties */
+export interface CharacterProperties {
+    fontFamily?: string;
+    fontSize?: number;
+    fontWeight?: 'normal' | 'bold';
+    fontStyle?: 'normal' | 'italic';
+    underline?: UnderlineStyle;
+    strikethrough?: boolean;
+    doubleStrikethrough?: boolean;
+    subscript?: boolean;
+    superscript?: boolean;
+    smallCaps?: boolean;
+    allCaps?: boolean;
+    hidden?: boolean;
+    color?: string;
+    highlight?: string;
+    shading?: ShadingDef;
+    border?: BorderDef;
+    spacing?: number;
+    position?: number;
+    scale?: number;
+    kerning?: number;
+    lang?: string;
+}
+/** Underline style */
+export interface UnderlineStyle {
+    style: 'single' | 'double' | 'thick' | 'dotted' | 'dottedHeavy' | 'dash' | 'dashHeavy' | 'dashLong' | 'dashLongHeavy' | 'dotDash' | 'dotDashHeavy' | 'dotDotDash' | 'dotDotDashHeavy' | 'wave' | 'wavyHeavy' | 'wavyDouble' | 'words' | 'none';
+    color?: string;
+}
+/** Table style properties */
+export interface TableStyleProperties {
+    tableProperties?: TableAttrs;
+    firstRow?: ConditionalTableFormatting;
+    lastRow?: ConditionalTableFormatting;
+    firstColumn?: ConditionalTableFormatting;
+    lastColumn?: ConditionalTableFormatting;
+    band1H?: ConditionalTableFormatting;
+    band2H?: ConditionalTableFormatting;
+    band1V?: ConditionalTableFormatting;
+    band2V?: ConditionalTableFormatting;
+    neCell?: ConditionalTableFormatting;
+    nwCell?: ConditionalTableFormatting;
+    seCell?: ConditionalTableFormatting;
+    swCell?: ConditionalTableFormatting;
+}
+/** Conditional table formatting */
+export interface ConditionalTableFormatting {
+    paragraphProperties?: ParagraphAttrs;
+    characterProperties?: CharacterProperties;
+    cellProperties?: TableCellAttrs;
+}
+/** Numbering style properties */
+export interface NumberingStyleProperties {
+    levels: NumberingLevel[];
+}
+/** Numbering level */
+export interface NumberingLevel {
+    level: number;
+    format: NumberingFormat;
+    text: string;
+    alignment?: TextAlignment;
+    start?: number;
+    restart?: number;
+    suffix?: 'tab' | 'space' | 'nothing';
+    paragraphProperties?: ParagraphAttrs;
+    characterProperties?: CharacterProperties;
+}
+/** Document template */
+export interface DocumentTemplate {
+    id: string;
+    name: string;
+    description?: string;
+    category?: string;
+    thumbnail?: string;
+    content: DocumentContent;
+    styles?: DocumentStyle[];
+    pageSetup?: PageSetup;
+    variables?: TemplateVariable[];
+    placeholders?: TemplatePlaceholder[];
+}
+/** Template variable */
+export interface TemplateVariable {
+    name: string;
+    label?: string;
+    type: 'text' | 'number' | 'date' | 'boolean' | 'select' | 'image';
+    defaultValue?: unknown;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    required?: boolean;
+    validation?: {
+        pattern?: string;
+        min?: number;
+        max?: number;
+        minLength?: number;
+        maxLength?: number;
+    };
+}
+/** Template placeholder */
+export interface TemplatePlaceholder {
+    id: string;
+    variable: string;
+    format?: string;
+    transform?: 'uppercase' | 'lowercase' | 'capitalize' | 'titlecase';
+}
+/** Tracked change */
+export interface TrackedChange {
+    id: string;
+    type: TrackedChangeType;
+    author: string;
+    date: Date;
+    content?: DocumentNode | TextNode;
+    original?: DocumentNode | TextNode;
+    range?: DocumentRange;
+    accepted?: boolean;
+    rejected?: boolean;
+}
+/** Tracked change type */
+export type TrackedChangeType = 'insert' | 'delete' | 'move' | 'formatChange' | 'paragraphChange' | 'tableChange' | 'cellMerge' | 'cellSplit';
+/** Document range */
+export interface DocumentRange {
+    start: DocumentPosition;
+    end: DocumentPosition;
+}
+/** Document position */
+export interface DocumentPosition {
+    paragraph: number;
+    offset: number;
+}
+/** Track changes configuration */
+export interface TrackChangesConfig {
+    enabled: boolean;
+    author?: string;
+    showInsertions?: boolean;
+    showDeletions?: boolean;
+    showFormatting?: boolean;
+    insertionColor?: string;
+    deletionColor?: string;
+    movesColor?: string;
+    formattingColor?: string;
+    showInBalloons?: boolean;
+    showInline?: boolean;
+    viewMode?: 'final' | 'original' | 'markup' | 'simple';
+}
+/** Document comment */
+export interface DocumentComment {
+    id: string;
+    author: string;
+    date: Date;
+    content: string;
+    range: DocumentRange;
+    replies?: CommentReply[];
+    resolved?: boolean;
+    resolvedBy?: string;
+    resolvedDate?: Date;
+    mentions?: string[];
+    status?: 'none' | 'todo' | 'inProgress' | 'done';
+}
+/** Comment reply */
+export interface CommentReply {
+    id: string;
+    author: string;
+    date: Date;
+    content: string;
+    mentions?: string[];
+}
+/** Footnote */
+export interface Footnote {
+    id: string;
+    content: ParagraphNode[];
+    type?: 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
+}
+/** Endnote */
+export interface Endnote {
+    id: string;
+    content: ParagraphNode[];
+}
+/** Footnote/Endnote properties */
+export interface NoteProperties {
+    position?: 'pageBottom' | 'beneathText' | 'sectionEnd' | 'documentEnd';
+    numberingFormat?: NumberingFormat;
+    startNumber?: number;
+    restartNumbering?: 'continuous' | 'section' | 'page';
+}
+/** Mail merge configuration */
+export interface MailMergeConfig {
+    type: 'letters' | 'emails' | 'envelopes' | 'labels' | 'directory';
+    dataSource: MailMergeDataSource;
+    document: DocumentContent;
+    outputFormat?: 'document' | 'print' | 'email';
+    emailSettings?: MailMergeEmailSettings;
+}
+/** Mail merge data source */
+export interface MailMergeDataSource {
+    type: 'json' | 'csv' | 'excel' | 'database' | 'api';
+    data?: Record<string, unknown>[];
+    url?: string;
+    query?: string;
+    connection?: string;
+}
+/** Mail merge email settings */
+export interface MailMergeEmailSettings {
+    to: string;
+    subject: string;
+    from?: string;
+    cc?: string;
+    bcc?: string;
+    attachDocument?: boolean;
+    attachmentFormat?: 'pdf' | 'docx';
+}
+/** Mail merge field */
+export interface MailMergeField {
+    name: string;
+    format?: string;
+    defaultValue?: string;
+    conditional?: MailMergeConditional;
+}
+/** Mail merge conditional */
+export interface MailMergeConditional {
+    field: string;
+    operator: 'equals' | 'notEquals' | 'greaterThan' | 'lessThan' | 'contains' | 'isEmpty' | 'isNotEmpty';
+    value?: string;
+    trueContent?: string;
+    falseContent?: string;
+}
+/** Mail merge preview */
+export interface MailMergePreview {
+    recordIndex: number;
+    totalRecords: number;
+    content: DocumentContent;
+    data: Record<string, unknown>;
+}
+/** Mail merge result */
+export interface MailMergeResult {
+    type: 'documents' | 'print' | 'email';
+    totalRecords: number;
+    successCount: number;
+    errorCount: number;
+    documents?: {
+        index: number;
+        data: ArrayBuffer;
+        filename: string;
+    }[];
+    errors?: {
+        index: number;
+        error: string;
+    }[];
+}
+/** Document import options */
+export interface DocumentImportOptions {
+    format: DocumentImportFormat;
+    encoding?: string;
+    preserveStyles?: boolean;
+    preserveImages?: boolean;
+    preserveTables?: boolean;
+    preserveComments?: boolean;
+    preserveTrackChanges?: boolean;
+}
+/** Import format */
+export type DocumentImportFormat = 'docx' | 'doc' | 'rtf' | 'odt' | 'html' | 'markdown' | 'txt' | 'pdf';
+/** Document export options */
+export interface DocumentExportOptions {
+    format: DocumentExportFormat;
+    includeStyles?: boolean;
+    includeImages?: boolean;
+    includeComments?: boolean;
+    includeTrackChanges?: boolean;
+    trackChangesMode?: 'final' | 'original' | 'all';
+    pdf?: PDFExportSettings;
+    html?: HTMLExportSettings;
+}
+/** Export format */
+export type DocumentExportFormat = 'docx' | 'doc' | 'rtf' | 'odt' | 'pdf' | 'html' | 'markdown' | 'txt' | 'epub';
+/** PDF export settings */
+export interface PDFExportSettings {
+    compliance?: 'pdf-a' | 'pdf-x' | 'none';
+    embedFonts?: boolean;
+    imageQuality?: number;
+    bookmarks?: boolean;
+    accessibility?: boolean;
+}
+/** HTML export settings */
+export interface HTMLExportSettings {
+    inlineStyles?: boolean;
+    inlineImages?: boolean;
+    includeDoctype?: boolean;
+    encoding?: string;
+}
+/** Document collaboration session */
+export interface DocumentCollaborationSession {
+    id: string;
+    documentId: string;
+    users: DocumentCollaborationUser[];
+    cursors: DocumentUserCursor[];
+    selections: DocumentUserSelection[];
+    version: number;
+    lastModified: Date;
+}
+/** Collaboration user */
+export interface DocumentCollaborationUser {
+    id: string;
+    name: string;
+    color: string;
+    avatar?: string;
+    online: boolean;
+    lastActivity?: Date;
+    isEditing?: boolean;
+}
+/** User cursor */
+export interface DocumentUserCursor {
+    userId: string;
+    position: DocumentPosition;
+    timestamp: Date;
+}
+/** User selection */
+export interface DocumentUserSelection {
+    userId: string;
+    range: DocumentRange;
+    timestamp: Date;
+}
+/** Document history entry */
+export interface DocumentHistoryEntry {
+    id: string;
+    timestamp: Date;
+    author?: string;
+    type: DocumentHistoryType;
+    description?: string;
+    changes: DocumentChange[];
+    undo: () => void;
+    redo: () => void;
+}
+/** History type */
+export type DocumentHistoryType = 'insert' | 'delete' | 'format' | 'paste' | 'replace' | 'table' | 'image' | 'style' | 'pageSetup' | 'comment' | 'composite';
+/** Document change */
+export interface DocumentChange {
+    type: string;
+    range?: DocumentRange;
+    before?: unknown;
+    after?: unknown;
+}
+/** Find options */
+export interface FindOptions {
+    query: string;
+    caseSensitive?: boolean;
+    wholeWord?: boolean;
+    regex?: boolean;
+    wildcards?: boolean;
+    matchPrefix?: boolean;
+    matchSuffix?: boolean;
+    sounds?: boolean;
+    findAllWordForms?: boolean;
+    formatting?: FindFormatting;
+}
+/** Find formatting */
+export interface FindFormatting {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    style?: string;
+    font?: string;
+    fontSize?: number;
+    color?: string;
+    highlight?: string;
+}
+/** Find result */
+export interface FindResult {
+    index: number;
+    range: DocumentRange;
+    text: string;
+    context?: string;
+}
+/** Replace options */
+export interface ReplaceOptions extends FindOptions {
+    replacement: string;
+    preserveCase?: boolean;
+    useFormatting?: FindFormatting;
+}
+/** Replace result */
+export interface ReplaceResult {
+    foundCount: number;
+    replacedCount: number;
+    results: {
+        range: DocumentRange;
+        originalText: string;
+        newText: string;
+    }[];
+}
+//# sourceMappingURL=word-processor.d.ts.map