/*!
 * Jodit Editor (https://xdsoft.net/jodit/)
 * Released under MIT see LICENSE.txt in the project root for license information.
 * Copyright (c) 2013-2026 Valerii Chupurnov. All rights reserved. https://xdsoft.net
 */
/**
 * @module types
 */
import type { Buttons, ButtonsGroup, ButtonsOption, Controls, IControlType, IProgressBar, IToolbarCollection } from "./toolbar";
import type { CanUndef, IComponent, IContainer, IDictionary, Nullable } from "./types";
import type { Attributes, ICreate } from "./create";
import type { IAsyncStorage, IAsyncStorageOptions, IStorage } from "./storage";
import type { IUIButtonState } from "./ui";
import type { IEventEmitter } from "./events";
import type { IPluginButton } from "./plugin";
import type { IElms, IMods } from "./traits";
import type { IMessages } from "./messages";
interface ILanguageOptions {
    language?: string;
    debugLanguage?: boolean;
    i18n?: IDictionary<IDictionary<string>> | false;
}
interface IToolbarOptions {
    toolbar?: boolean | string | HTMLElement;
    readonly theme?: string;
    readonly toolbarButtonSize?: IUIButtonState['size'];
    readonly textIcons?: boolean | ((key: string) => boolean);
    readonly extraButtons?: Buttons;
    readonly removeButtons?: string[];
    readonly extraIcons?: IDictionary<string>;
    readonly buttons?: ButtonsOption;
    readonly showTooltip?: boolean;
    readonly showTooltipDelay?: number;
    readonly useNativeTooltip?: boolean;
    readonly direction?: string;
}
type NodeFunction = (elm: HTMLElement) => void;
interface IViewOptions extends ILanguageOptions, IToolbarOptions {
    /**
     * Use cache for heavy methods
     */
    cache?: boolean;
    /**
     * Configure the provider that backs {@link IViewBased.asyncStorage}.
     * By default it uses persistent `IndexedDB` (with an in-memory fallback);
     * set `defaultProvider` to `'local'`, `'memory'` or a custom
     * {@link IAsyncStorage} implementation to override it.
     */
    asyncStorage?: IAsyncStorageOptions;
    getIcon?: (name: string, clearName: string) => CanUndef<string>;
    headerButtons?: string | Array<IControlType | string | ButtonsGroup>;
    readonly basePath?: string;
    /**
     * Plugin autoloader should load minified version of the file
     */
    readonly minified?: boolean;
    theme?: string;
    defaultTimeout?: number;
    disabled?: boolean;
    readonly?: boolean;
    iframe?: boolean;
    direction?: 'ltr' | 'rtl' | '';
    namespace?: string;
    activeButtonsInReadOnly?: string[];
    allowTabNavigation?: boolean;
    zIndex?: number | string;
    fullsize?: boolean;
    globalFullSize?: boolean;
    controls?: Controls;
    createAttributes?: IDictionary<Attributes | NodeFunction>;
    events?: IDictionary<(...args: any[]) => any>;
    shadowRoot?: Nullable<ShadowRoot>;
    /**
     * CSP nonce applied to every `<style>`/`<script>`/`<link>` element Jodit
     * injects at runtime, so a strict `style-src`/`script-src` policy does not
     * block them.
     */
    nonce?: string;
    popupRoot?: Nullable<HTMLElement>;
    ownerWindow?: Window;
    language?: string;
    eventEmmiter?: IEventEmitter;
}
interface IViewBased<T = IViewOptions> extends IContainer, IComponent, IMods, IElms {
    readonly isView: true;
    readonly parent: Nullable<IViewBased>;
    /**
     * ID attribute for a source element, id add \{id\}_editor it's editor's id
     */
    readonly id: string;
    readonly basePath: string;
    readonly minified: boolean;
    readonly isLocked: boolean;
    isLockedNotBy(name: string): boolean;
    lock(name?: string): boolean;
    unlock(): boolean;
    readonly isFullSize: boolean;
    toggleFullSize(isFullSize?: boolean): void;
    readonly buffer: IStorage;
    /** @deprecated Use asyncStorage instead */
    readonly storage: IStorage;
    readonly asyncStorage: IAsyncStorage;
    readonly progressbar: IProgressBar;
    readonly events: IEventEmitter;
    readonly e: this['events'];
    readonly create: ICreate;
    readonly c: this['create'];
    readonly OPTIONS: T;
    readonly options: this['OPTIONS'];
    // alias
    readonly o: this['options'];
    i18n(text: string, ...params: Array<string | number>): string;
    readonly defaultTimeout: number;
    getVersion(): string;
    readonly components: Set<IComponent>;
    getInstance<T extends IComponent>(module: Function, options?: object): T;
    getInstance<T extends IComponent>(moduleName: string, options?: object): T;
    readonly message: IMessages;
}
interface IViewWithToolbar<T = IViewOptions> extends IViewBased<T> {
    toolbar: IToolbarCollection;
    toolbarContainer: HTMLElement;
    registeredButtons: Set<IPluginButton>;
    registerButton(btn: IPluginButton): this;
    unregisterButton(btn: IPluginButton): this;
    getRegisteredButtonGroups(): IDictionary<string[]>;
    setPanel(element: HTMLElement | string): void;
}