/**
 * Document Agent
 *
 * Headless, framework-agnostic API for inspecting and editing the
 * Document model. Used by `@eigenpal/docx-editor-agents` and any
 * adapter that wants agent capabilities without UI.
 * @packageDocumentation
 * @public
 */
export { A as AgentContextOptions, S as ContextSelectionOptions, D as DocumentAgent, E as ExtendedSelectionContext, F as FormattedTextSegment, a as FormattingSummary, I as InsertHyperlinkOptions, b as InsertImageOptions, c as InsertTableOptions, d as InsertTextOptions, e as SelectionContextOptions, f as buildExtendedSelectionContext, g as buildSelectionContext, h as buildSelectionContextFromContext, i as createAgent, j as createAgentFromDocument, k as executeCommand, l as executeCommands, m as getAgentContext, n as getDocumentSummary, o as getSelectionFormattingSummary } from '../selectionContext-BJZZW1JA.js';
import { T as TextFormatting } from '../formatting-JhqWT_XM.js';
import { D as DocumentBody, P as Paragraph, H as Hyperlink, l as Run, T as Table, s as SdtType, t as SdtProperties } from '../content-B8ScSBzC.js';
import { Position } from '../types/agentApi.js';
export { AIAction, AIActionRequest, AgentCommand, AgentContext, AgentResponse, SelectionContext as AgentSelectionContext, ApplyStyleCommand, ApplyVariablesCommand, DEFAULT_AI_ACTIONS, DeleteTextCommand, FormatParagraphCommand, FormatTextCommand, InsertHyperlinkCommand, InsertImageCommand, InsertParagraphBreakCommand, InsertTableCommand, InsertTextCommand, MergeParagraphsCommand, ParagraphContext, ParagraphOutline, Range, RemoveHyperlinkCommand, ReplaceTextCommand, SectionInfo, SetVariableCommand, SplitParagraphCommand, StyleInfo, SuggestedAction, comparePositions, createCollapsedRange, createCommand, createRange, getActionDescription, getActionLabel, isPositionInRange } from '../types/agentApi.js';
import { b as ContentControlInfo, a as ContentControlFilter } from '../contentControlValues-CxwmLrCX.js';
export { C as ContentControlBoundError, c as ContentControlKindError, d as ContentControlLocation, e as ContentControlLockedError, f as ContentControlNotFoundError, g as ContentControlTypeError, h as ContentControlValue, i as ContentControlValueError, F as FindContentControlsOptions, j as findContentControl, k as findContentControls, l as formatSdtDate, m as getContentControlText, r as removeContentControl, s as setContentControlContent, n as setContentControlValue } from '../contentControlValues-CxwmLrCX.js';
import { Document } from '../types/document.js';
import '../selectiveSave-CWaPEv0B.js';
import '../docxInput-DTbCa48g.js';
import '../colors-C3vA7HUU.js';
import '../docx/wrapTypes.js';
import '../lists-Bn29SzeS.js';
import '../watermark-D90356ZM.js';
import '../styles-BGGjYqnf.js';

/**
 * Shared Text Utilities for Agent Module
 *
 * Common text extraction and manipulation utilities used by
 * context.ts, selectionContext.ts, and other agent-related code.
 *
 * Consolidates duplicated helper functions into a single location.
 */

/**
 * Get plain text from a paragraph
 */
declare function getParagraphText(paragraph: Paragraph): string;
/**
 * Get plain text from a run
 */
declare function getRunText(run: Run): string;
/**
 * Get plain text from a hyperlink
 */
declare function getHyperlinkText(hyperlink: Hyperlink): string;
/**
 * Get plain text from a table
 */
declare function getTableText(table: Table): string;
/**
 * Get plain text from document body
 */
declare function getBodyText(body: DocumentBody): string;
/**
 * Count words in text
 */
declare function countWords(text: string): number;
/**
 * Count characters in text
 */
declare function countCharacters(text: string, includeSpaces?: boolean): number;
/**
 * Get word count from document body
 */
declare function getBodyWordCount(body: DocumentBody): number;
/**
 * Get character count from document body
 */
declare function getBodyCharacterCount(body: DocumentBody): number;
/**
 * Get text before a position
 *
 * @param paragraphs - Array of paragraphs
 * @param position - Position to get text before
 * @param maxChars - Maximum characters to return
 * @returns Text before the position
 */
declare function getTextBefore(paragraphs: Paragraph[], position: Position, maxChars: number): string;
/**
 * Get text after a position
 *
 * @param paragraphs - Array of paragraphs
 * @param position - Position to get text after
 * @param maxChars - Maximum characters to return
 * @returns Text after the position
 */
declare function getTextAfter(paragraphs: Paragraph[], position: Position, maxChars: number): string;
/**
 * Get formatting at a specific position in a paragraph
 *
 * @param paragraph - The paragraph to check
 * @param offset - Character offset in the paragraph
 * @returns Formatting at that position
 */
declare function getFormattingAtPosition(paragraph: Paragraph, offset: number): Partial<TextFormatting>;
/**
 * Check if position is within a hyperlink
 *
 * @param paragraph - The paragraph to check
 * @param offset - Character offset in the paragraph
 * @returns True if position is in a hyperlink
 */
declare function isPositionInHyperlink(paragraph: Paragraph, offset: number): boolean;
/**
 * Get hyperlink at position
 *
 * @param paragraph - The paragraph to check
 * @param offset - Character offset in the paragraph
 * @returns The hyperlink at that position, or undefined
 */
declare function getHyperlinkAtPosition(paragraph: Paragraph, offset: number): Hyperlink | undefined;
/**
 * Check if style ID represents a heading
 *
 * @param styleId - Style ID to check
 * @returns True if it's a heading style
 */
declare function isHeadingStyle(styleId?: string): boolean;
/**
 * Parse heading level from style ID
 *
 * @param styleId - Style ID to parse
 * @returns Heading level (1-9) or undefined
 */
declare function parseHeadingLevel(styleId?: string): number | undefined;
/**
 * Check if document body has images
 *
 * @param body - Document body to check
 * @returns True if contains images
 */
declare function hasImages(body: DocumentBody): boolean;
/**
 * Check if document body has hyperlinks
 *
 * @param body - Document body to check
 * @returns True if contains hyperlinks
 */
declare function hasHyperlinks(body: DocumentBody): boolean;
/**
 * Check if document body has tables
 *
 * @param body - Document body to check
 * @returns True if contains tables
 */
declare function hasTables(body: DocumentBody): boolean;
/**
 * Get all paragraphs from document body
 *
 * @param body - Document body
 * @returns Array of paragraphs
 */
declare function getParagraphs(body: DocumentBody): Paragraph[];
/**
 * Get paragraph at index from document body
 *
 * @param body - Document body
 * @param index - Paragraph index (0-indexed)
 * @returns Paragraph or undefined
 */
declare function getParagraphAtIndex(body: DocumentBody, index: number): Paragraph | undefined;
/**
 * Get block index for a paragraph index
 *
 * @param body - Document body
 * @param paragraphIndex - Paragraph index
 * @returns Block index or -1 if not found
 */
declare function getBlockIndexForParagraph(body: DocumentBody, paragraphIndex: number): number;

/**
 * Create a new inline content control (`w:sdt`) by wrapping a text span.
 *
 * Complements the discovery/edit functions in {@link ./contentControls}: where
 * those find and mutate existing controls, this wraps an exact run of text
 * inside a paragraph in a new control with a synthesized, Word-correct
 * `w:sdtPr`. Pure — the input {@link Document} is not mutated.
 */

/** A create request failed: the target couldn't be resolved, or the wrap is invalid. */
declare class ContentControlCreateError extends Error {
    constructor(message: string);
}
/**
 * Where to create a control: an exact text span inside a paragraph. The
 * paragraph is located by Word `w14:paraId`, and the chosen `occurrence` of
 * `text` is wrapped in an inline control — including inside a table cell, where
 * block-level controls aren't allowed.
 */
interface CreateContentControlTarget {
    /** Word `w14:paraId` of the paragraph containing the text. */
    paraId: string;
    /** Exact substring to wrap. */
    text: string;
    /** Which occurrence of `text` to wrap when it repeats (1-based; default 1). */
    occurrence?: number;
}
/** Modeled properties for a control created by {@link createContentControl}. */
interface NewContentControlProps {
    /** Control type (default `richText`). */
    sdtType?: SdtType;
    /** Developer identifier (`w:tag`). */
    tag?: string;
    /** Friendly name (`w:alias`). */
    alias?: string;
    /** Numeric id (`w:id`). Default: auto-assigned, unique across the document. */
    id?: number;
    /** Lock setting (`w:lock`). */
    lock?: SdtProperties['lock'];
    /** Dropdown/combobox list items. */
    listItems?: {
        displayText: string;
        value: string;
    }[];
    /** Date display format (`w:date/w:dateFormat`), for `date` controls. */
    dateFormat?: string;
    /** Initial checkbox state, for `checkbox` controls. */
    checked?: boolean;
    /** Whether the control starts in placeholder state (`w:showingPlcHdr`). */
    showingPlaceholder?: boolean;
}
/**
 * Wrap an exact text span inside a paragraph in a new inline content control
 * (`w:sdt`), returning a new {@link Document} and the created control's
 * {@link ContentControlInfo}. Pure — the input is not mutated. This is the form
 * needed inside table cells and mid-sentence, where block controls aren't
 * allowed: runs are split at the span boundaries (formatting preserved) and
 * interior fields/tabs/breaks are kept wholesale.
 *
 * The control's `w:sdtPr` is synthesized from `props`, and its `w:id` is
 * auto-assigned (unique across the document) when `props.id` is omitted, so the
 * control round-trips and `findContentControl(doc, { tag })` resolves it after a
 * save/reload.
 *
 * **Body only:** the search covers body paragraphs and block/table content —
 * paragraphs inside headers or footers are not reachable. Passing a `paraId`
 * from a header/footer part throws {@link ContentControlCreateError} with a
 * "No paragraph found" message.
 *
 * @throws {@link ContentControlCreateError} when the paragraph or text isn't
 * found, the span overlaps an existing control or crosses a non-run boundary,
 * the `sdtType` can't be synthesized, or a supplied `id` already exists.
 */
declare function createContentControl(doc: Document, target: CreateContentControlTarget, props?: NewContentControlProps): {
    doc: Document;
    control: ContentControlInfo;
};

/**
 * Repeating-section (w15:repeatingSection) support — add and remove repeated
 * items, the way Word's "+" affordance does. A repeating section is a block
 * content control whose `w:sdtPr` carries `<w15:repeatingSection>`; its direct
 * children are item controls each carrying `<w15:repeatingSectionItem>`.
 *
 * Adding clones an existing item (with a fresh, unique `w:id`) and inserts it
 * after; removing drops one item but keeps at least one. The w15 elements ride
 * in the captured raw `w:sdtPr` (they're unmodeled), so we detect and patch the
 * raw string rather than re-serializing.
 */

/** The control's raw `w:sdtPr` declares it a repeating section (the container). */
declare function isRepeatingSection(props: SdtProperties): boolean;
/** The control's raw `w:sdtPr` declares it a repeating-section item. */
declare function isRepeatingSectionItem(props: SdtProperties): boolean;
/** Raised when an operation targets something that isn't a repeating section/item. */
declare class RepeatingSectionError extends Error {
    constructor(message: string);
}
/**
 * Add a new repeating-section item, cloned from an existing one and inserted
 * after it. `afterIndex` is the item ordinal to clone/insert after (default:
 * the last item). Returns a new {@link Document}.
 */
declare function addRepeatingSectionItem(doc: Document, filter: ContentControlFilter, options?: {
    afterIndex?: number;
}): Document;
/**
 * Remove the repeating-section item at ordinal `index`. Keeps at least one item
 * (Word does not allow removing the last). Returns a new {@link Document}.
 */
declare function removeRepeatingSectionItem(doc: Document, filter: ContentControlFilter, index: number): Document;

export { ContentControlCreateError, ContentControlFilter, ContentControlInfo, type CreateContentControlTarget, type NewContentControlProps, Position, RepeatingSectionError, addRepeatingSectionItem, countCharacters, countWords, createContentControl, getBlockIndexForParagraph, getBodyCharacterCount, getBodyText, getBodyWordCount, getFormattingAtPosition, getHyperlinkAtPosition, getHyperlinkText, getParagraphAtIndex, getParagraphText, getParagraphs, getRunText, getTableText, getTextAfter, getTextBefore, hasHyperlinks, hasImages, hasTables, isHeadingStyle, isPositionInHyperlink, isRepeatingSection, isRepeatingSectionItem, parseHeadingLevel, removeRepeatingSectionItem };