import { EditorView } from '@codemirror/view';
import type { AriaLabelingProps } from '../../core/types/a11y-props.js';
import type { BehaviorTrackingProps } from '../../core/types/behavior-tracking-props.js';
import type { DataTestId } from '../../core/types/data-props.js';
import type { FormControlStateProps } from '../../core/types/form-control-state.js';
import type { MaskingProps } from '../../core/types/masking-props.js';
import type { StylingProps } from '../../core/types/styling-props.js';
import type { MessageTarget } from '../../forms/validation/message-routing.js';
import type { ValidationState } from '../../forms/validation/types.js';
import type { InlineDiagnostic } from '../code-editor/inline-diagnostic.js';
import type { EditorLanguageConfiguration } from './configuration/configuration.js';
import type { GutterConfiguration } from './configuration/getDefaultConfigurations.js';
/**
 * Props shared by all code editor components.
 * @public
 */
export interface SharedBaseCodeEditorProps extends FormControlStateProps, AriaLabelingProps, StylingProps, DataTestId, MaskingProps, BehaviorTrackingProps {
    /**
     * The ID for the DOM element.
     */
    id?: string;
    /**
     * Callback that is called when the value in the editor changes.
     */
    onChange?: (value: string) => void;
    /**
     * Displayed initially in the editor when there is no other content.
     */
    placeholder?: string;
    /**
     * Whether spellcheck should be enabled.
     * @defaultValue false
     */
    spellCheck?: boolean;
    /**
     * If set to true, the code editor uses the full height available in its parent.
     * @defaultValue false
     */
    fullHeight?: boolean;
    /**
     * The start indices (character position) that should be folded initially in uncontrolled scenarios.
     */
    defaultFolding?: number[];
    /**
     * The start indices (character position) that should be folded initially in controlled scenarios.
     */
    folding?: number[];
    /**
     * Callback that is called when folding changes.
     */
    onFoldingChange?: (values: number[]) => void;
    /**
     * Whether the input is readonly.
     * @defaultValue false
     */
    readOnly?: boolean;
    /**
     * Whether long lines should be wrapped.
     * @defaultValue false
     */
    lineWrap?: boolean;
    /**
     * Callback that is called when the editor loses focus.
     */
    onBlur?: (e: FocusEvent) => void;
    /**
     * Callback that is called when the editor receives focus.
     */
    onFocus?: (e: FocusEvent) => void;
    /**
     * Editor layout size, 'default' for standard spacing and 'condensed' for reduced font size, padding and margins.
     * @defaultValue 'default'
     */
    size?: 'default' | 'condensed';
    /**
     * If set to true, `aria-required` will be set to true on the input element.
     * @defaultValue false
     */
    required?: boolean;
    /**
     * Opts in to fully controlled semantics on `value`. When `true`, every user
     * keystroke is blocked until the consumer updates `value` in response to
     * `onChange`; the editor always reflects `value` exactly.
     *
     * When `false` (the default), `value` seeds and re-syncs the document but
     * user keystrokes are applied immediately without waiting for `onChange`.
     *
     * @remarks
     * IME composition transactions are always let through so that candidate
     * characters display correctly during an active IME session.
     * Autocomplete completions (selecting an item) are applied immediately and
     * forwarded via `onChange` so the consumer can accept the new value.
     *
     * @deprecated Will be removed when controlled behaviour becomes the default.
     * @defaultValue false
     */
    isControlled?: boolean;
}
/**
 * Base props shared by both controlled and uncontrolled `BaseCodeEditor` usages.
 * @internal
 **/
export interface BaseCodeEditorBaseProps extends SharedBaseCodeEditorProps {
    /**
     * The language configuration.
     */
    configuration?: EditorLanguageConfiguration;
    /**
     * If set to true, the code editor allows only one line and the line number will not be displayed.
     * @defaultValue false
     */
    singleLine?: boolean;
    /**
     * If set to true, the code editor will hide the line numbers.
     * @defaultValue false
     */
    hideLineNumbers?: boolean;
    /**
     * Provides the gutter configuration to display a marker next to the fold gutter.
     * @deprecated Use the `diagnostics` and `showLintGutter` props for per-line validation markers instead.
     * Will be removed in a future major release.
     */
    gutterConfiguration?: GutterConfiguration;
    /**
     * Formatter function that receives the current value and returns the formatted value.
     * When provided, registers a keyboard shortcut for formatting.
     */
    format?: (value: string) => string;
    /**
     * Diagnostics to render inside the editor (underlines, hover tooltips).
     * When provided, the built-in JSON linter is overridden.
     */
    diagnostics?: InlineDiagnostic[];
    /**
     * When `true`, shows a severity marker in a gutter column next to each diagnostic line.
     * Has no effect when `diagnostics` is `undefined` or empty.
     * @defaultValue false
     */
    showLintGutter?: boolean;
    /**
     * Renders floating pill buttons at the top and/or bottom edge of the editor
     * when one or more `error`-severity diagnostics are scrolled out of the visible area.
     * @defaultValue false
     */
    showOffScreenDiagnosticIndicators?: boolean;
    /**
     * The name attribute for form association. When set, the editor registers
     * with an enclosing `<Form>` so its value is included in the submit snapshot.
     */
    name?: string;
    /**
     * Callback fired when the editor's validation state changes.
     *
     * Emits after the first blur (focus-gating). Subsequent emissions are
     * deduplicated when the set of error keys is unchanged. The `status` field
     * indicates whether a lint run is still in progress (`'pending'`) or has
     * settled (`'done'`). `errors` holds the last settled result while
     * `'pending'`, so messages do not blink out while the field revalidates.
     */
    onValidityChange?: (state: ValidationState) => void;
    /**
     * Associates the control with a specific `<Form>` element by its id.
     * @internal
     */
    _form?: string;
    /**
     * Controls where Strato validation messages are routed.
     * @internal
     */
    _messageTarget?: MessageTarget | MessageTarget[];
}
/**
 * Props for the `BaseCodeEditor` in controlled usage.
 * @internal
 */
export type BaseCodeEditorControlledProps = {
    /**
     * The contents of the editor. Treated as the initial CodeMirror document and
     * synchronised with the editor on subsequent prop changes.
     * @defaultValue ''
     */
    value?: string;
    defaultValue?: never;
};
/**
 * Props for the `BaseCodeEditor` in uncontrolled usage.
 * @internal
 */
export type BaseCodeEditorUncontrolledProps = {
    value?: never;
    /**
     * The initial contents of the editor for uncontrolled usage. Used only when the
     * editor mounts; subsequent changes to this prop are ignored.
     */
    defaultValue?: string;
};
/**
 * Props used for BaseCodeEditor.
 * @internal
 */
export type BaseCodeEditorProps = BaseCodeEditorBaseProps & (BaseCodeEditorControlledProps | BaseCodeEditorUncontrolledProps);
/**
 * public ref type
 * @internal
 */
export type BaseCodeEditorRef = {
    /**
     * Moves focus to the editor.
     */
    focus: () => void;
    /**
     * Selects the text within the given character-offset range.
     */
    selectRange: (range: {
        from: number;
        to: number;
    }) => void;
    /**
     * The underlying editor container DOM element.
     */
    readonly element: HTMLDivElement | null;
    /**
     * Moves the cursor to the given character offset, or to the end of the document when `'end'` is passed.
     */
    setCursorPosition: (position: number | 'end') => void;
    /**
     * The underlying `EditorView` instance for direct CodeMirror access.
     * @internal
     */
    editorView?: () => EditorView;
    /**
     * Formats the editor content using the `format` prop function, if provided.
     */
    format?: () => void;
    /**
     * Runs validation imperatively and resolves with the current
     * `ValidationState`. When a built-in async lint run is still in progress,
     * `forceLinting` is called and the promise waits for the run to settle.
     */
    validate: () => Promise<ValidationState>;
};
/**
 * Provides a base/core component for other code editors to share a common base.
 *
 * @internal
 */
export declare const BaseCodeEditor: (props: BaseCodeEditorProps & import("react").RefAttributes<BaseCodeEditorRef>) => import("react").ReactElement | null;
//# sourceMappingURL=BaseCodeEditor.d.ts.map