@emailmaker/emailmaker 1.1.64 → 1.1.69

package/file-manager/types.d.ts

@@ -0,0 +1,817 @@
+import React, { ReactNode, RefObject } from 'react';
+import type { FormInstance } from 'antd';
+import { MY_FILES, GIF, STOCK_IMAGES, ICONS, AI, IMAGE_CODES, EDITOR, IMAGE_EXTENSIONS } from './constants';
+import type { InputRef } from 'antd';
+import type { TextAreaRef } from 'antd/es/input/TextArea';
+import type { FileManageErrorInfo, Notify, NotifyEvent } from './notification';
+export * from './notification';
+export interface Folder {
+    id: string;
+    name: string;
+    parentId?: string | null;
+    childCount?: number;
+}
+export interface ThumbnailFile {
+    thumbnail: string;
+    name?: string;
+    id?: string;
+    type?: string;
+    extension?: string;
+    size?: number;
+    sourceUrl?: string;
+    saveWithoutFolder?: boolean;
+}
+export interface File {
+    id: string;
+    name: string;
+    size?: number;
+    folderId: string;
+    date?: string;
+    type?: string;
+    url?: string;
+    thumbnail?: string;
+    thumbnailUrl?: string;
+    dimensions?: string;
+    aspectRatio?: string;
+    extension?: string;
+    selected?: boolean;
+    isFolder?: boolean;
+    lastEdited?: string;
+    childCount?: number;
+    sourceUrl?: string;
+    saveWithoutFolder?: boolean;
+}
+export interface PixieSavePayload {
+    blob: UploadBinary;
+    mimeType: string;
+    thumbnail: string;
+    /** Обычное сохранение или «Сохранить как копию». */
+    mode: 'save' | 'saveCopy';
+}
+/** Передаётся вторым аргументом в `onEditorOk` после сохранения из Pixie. */
+export type EditorSaveMeta = Pick<PixieSavePayload, 'mode'>;
+export interface PathItem {
+    id: string;
+    name: string;
+}
+export interface PaginationState {
+    current: number;
+    pageSize: number;
+    total: number;
+}
+export interface FilesQueryParams {
+    folderId?: string;
+    noFolder?: boolean;
+    search?: string;
+    page?: number;
+    limit?: number;
+    sortBy?: 'name' | 'size' | 'date' | 'type';
+    sortOrder?: 'asc' | 'desc';
+    itemType?: 'file' | 'folder' | 'all';
+    /** Имя папки для уведомлений; не уходит в dataProviders.getFiles при явной передаче полей. */
+    folderName?: string;
+}
+export interface ApiPaginationResponse {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+export interface FilesApiResponse {
+    data: File[];
+    pagination: ApiPaginationResponse;
+}
+export interface SortState {
+    sortBy: 'name' | 'size' | 'date' | 'type';
+    sortOrder: 'asc' | 'desc';
+}
+export interface MenuItem {
+    key: string;
+    label: string | ReactNode;
+    icon?: ReactNode;
+    children?: MenuItem[];
+}
+export interface ApiEndpoints {
+    getFolders?: string;
+    getFiles?: string;
+    createFolder?: string;
+    deleteFolder?: string;
+    addFile?: string;
+    deleteFile?: string;
+    renameFile?: string;
+    moveFile?: string;
+    updateFile?: string;
+    clearCache?: string;
+}
+export interface IconProps {
+    style?: React.CSSProperties;
+    className?: string;
+    onClick?: React.MouseEventHandler<HTMLElement>;
+    [key: string]: unknown;
+}
+export interface CustomIcons {
+    rootFolder?: React.ComponentType<IconProps>;
+    folder?: React.ComponentType<IconProps>;
+    folderOpen?: React.ComponentType<IconProps>;
+    addFolder?: React.ComponentType<IconProps>;
+    file?: React.ComponentType<IconProps>;
+    upload?: React.ComponentType<IconProps>;
+    uploadByUrl?: React.ComponentType<IconProps>;
+    expandArrow?: React.ComponentType<IconProps>;
+    collapseArrow?: React.ComponentType<IconProps>;
+    gridView?: React.ComponentType<IconProps>;
+    listView?: React.ComponentType<IconProps>;
+    folderPreview?: React.ComponentType<IconProps>;
+    mixedView?: React.ComponentType<IconProps>;
+    landscapeView?: React.ComponentType<IconProps>;
+    portraitView?: React.ComponentType<IconProps>;
+    squareView?: React.ComponentType<IconProps>;
+    lightMode?: React.ComponentType<IconProps>;
+    darkMode?: React.ComponentType<IconProps>;
+    aiIcon_2?: React.ComponentType<IconProps>;
+    noFiles?: React.ComponentType<IconProps>;
+    thumbsUp?: React.ComponentType<IconProps>;
+}
+type MayBePromise<T> = T | Promise<T>;
+export type NotifyListener<T> = (value: T) => MayBePromise<void | false | (NotifyEvent & Notify)>;
+export interface FileManagerOptions {
+    apiEndpoints?: {
+        getFolders?: string;
+        getFiles?: string;
+        addFile?: string;
+        deleteFile?: string;
+        createFolder?: string;
+        deleteFolder?: string;
+        renameFile?: string;
+        moveFile?: string;
+        updateFile?: string;
+        clearCache?: string;
+    };
+    dataProviders?: FileManagerDataProviders;
+    searchQuery?: string;
+    sortBySize?: string;
+    onPathChange?: (path: string[]) => void;
+    onChangeSelection?: (files: File[]) => void;
+    onEditorOk?: (file: {
+        id: string;
+        folderId: string | undefined;
+        name: string;
+    }, meta?: EditorSaveMeta) => void | Promise<void>;
+    config?: Config;
+    customIcons?: CustomIcons;
+    dragDropIcon?: string;
+    handleNotify?: NotifyListener<NotifyEvent>;
+    handleError?: NotifyListener<Notify.ErrorEvent>;
+    handleSuccess?: NotifyListener<Notify.SuccessEvent>;
+    /** Резолвер DOM-контейнера для модальных окон FM.
+     *  Позволяет направить портал antd Modal внутрь file-manager-modal-root,
+     *  чтобы модалки оставались в контексте стилей (в т.ч. Shadow DOM). */
+    getModalContainer?: () => HTMLElement;
+}
+/**
+ * Результат операции
+ */
+export interface OperationResult<T = void> {
+    /**
+     * Корреляционный идентификатор элемента запроса.
+     * Ранее использовалось поле `id`, которое остаётся для обратной совместимости.
+     */
+    requestId?: string;
+    success?: boolean;
+    data?: T;
+    error?: FileManageErrorInfo;
+}
+/**
+ * Результат групповой операции
+ */
+export type BatchResult<T> = {
+    success: boolean;
+    error?: FileManageErrorInfo;
+    detailed?: OperationResult<T>[];
+};
+export type UploadBinary = Blob | globalThis.File;
+export interface UploadFileItemInput {
+    /**
+     * Произвольный идентификатор для сопоставления результата.
+     * Если не указан, сопоставление выполняется по порядку элементов.
+     */
+    requestId?: string;
+    name: string;
+    size: number;
+    type: string;
+    folderId?: string | null;
+    /**
+     * Бинарные данные файла. При наличии реального File он передается как есть,
+     * иначе — Blob (например, после конвертации base64).
+     */
+    data: UploadBinary;
+    extension?: string;
+    noFolder?: boolean;
+}
+export interface UploadFileResultData {
+    id?: string;
+    name?: string;
+    folderId?: string | null;
+    url?: string;
+    thumbnailUrl?: string;
+    thumbnail?: string;
+}
+export interface UploadFilesRequest {
+    /**
+     * Список загружаемых файлов. Порядок элементов важен — при отсутствии requestId
+     * сопоставление результатов выполняется по индексу.
+     */
+    items: UploadFileItemInput[];
+    folderId?: string | null;
+}
+/** Метаданные элемента из кэша хоста (getItem). */
+export interface FileManagerItemMeta {
+    id: string;
+    name: string;
+    isFolder: boolean;
+}
+export interface FileManagerDataProviders {
+    /**
+     * Имя/тип по id из кэша хоста (уже загруженные папки и файлы).
+     * Опционально; для уведомлений и подписей в UI.
+     */
+    getItem?: (id: string) => Promise<FileManagerItemMeta | null> | FileManagerItemMeta | null;
+    /** Метаданные файла по id (кэш хоста, затем pathMode). */
+    getFileById?: (fileId: string) => Promise<File | null>;
+    getFileData: (fileId: string) => Promise<Blob>;
+    findFileByUrl?: (url: string) => Promise<File | null>;
+    getFolders?: (options?: {
+        parentId?: string | null;
+        deep?: boolean;
+    }) => Promise<Folder[]>;
+    getChildrenCount?: (folderId?: string) => Promise<number>;
+    getFiles: (options: {
+        folderId?: string;
+        noFolder?: boolean;
+        search?: string;
+        sortBy?: SortState['sortBy'];
+        sortOrder?: SortState['sortOrder'];
+        page?: number;
+        limit?: number;
+        itemType: 'file' | 'folder' | 'all';
+    }) => Promise<{
+        files: File[];
+        pagination?: Partial<ApiPaginationResponse>;
+    }>;
+    createFolder: (data: {
+        name: string;
+        parentId?: string | null;
+        is_force_create?: boolean;
+    }) => Promise<Folder>;
+    renameFolder?: (folderId: string, newName: string) => Promise<Folder>;
+    deleteFolder?: (folderId: string) => Promise<boolean>;
+    uploadFile?: (file: {
+        name: string;
+        size: number;
+        type: string;
+        folderId?: string | null;
+        noFolder?: boolean;
+        /**
+         * Бинарные данные файла. При наличии real File передается сам File,
+         * в остальных случаях — Blob.
+         */
+        data: UploadBinary;
+        thumbnail?: string;
+        dimensions?: string;
+        aspectRatio?: string;
+        extension?: string;
+    }) => Promise<File>;
+    uploadFiles?: (request: UploadFilesRequest) => Promise<BatchResult<UploadFileResultData>>;
+    uploadFileByUrl?: (data: {
+        url: string;
+        folderId?: string | null;
+        noFolder?: boolean;
+        name?: string;
+        /** Источник события загрузки для аналитики */
+        eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif';
+    }) => Promise<File>;
+    deleteItems?: (items: string[], options?: {
+        permanent?: boolean;
+    }) => Promise<BatchResult<unknown>>;
+    cleanTrash?: () => Promise<{
+        success: boolean;
+        deletedCount?: number;
+    }>;
+    renameFile?: (fileId: string, newName: string) => Promise<File>;
+    moveItems?: (targetFolderId: string, files: string[]) => Promise<BatchResult<unknown>>;
+    copyItem?: (options: {
+        itemId: string;
+        targetFolderId: string;
+        isFolder: boolean;
+        /** При конфликте имени в целевой папке — использовать это имя для копии */
+        newName?: string;
+    }) => Promise<boolean>;
+    copyItems?: (targetFolderId: string, items: Array<{
+        id: string;
+        newName?: string;
+    }> | string[]) => Promise<BatchResult<unknown>>;
+    updateFile?: (fileId: string, updates: {
+        name?: string;
+        type?: string;
+        /**
+         * Обновленные бинарные данные (File или Blob). Если не переданы —
+         * используются старые данные.
+         */
+        data?: UploadBinary;
+        thumbnail?: string;
+        dimensions?: string;
+        aspectRatio?: string;
+        extension?: string;
+    }) => Promise<File>;
+    clearCache?: (pathFolder?: string | null) => Promise<void>;
+}
+export interface FileManagerHookReturn {
+    folders: Folder[];
+    files: File[];
+    filteredItems: File[];
+    paginatedItems: File[];
+    pagination: PaginationState;
+    selectedFolder: string | null;
+    searchTerm: string;
+    sortField: string;
+    pathHistory: PathItem[];
+    selectedFiles: Set<string>;
+    loading: boolean;
+    isModalVisible: boolean;
+    isUrlModalVisible: boolean;
+    isRenameModalVisible: boolean;
+    isMoveModalVisible: boolean;
+    form: FormInstance;
+    urlForm: FormInstance;
+    renameForm: FormInstance;
+    moveForm: FormInstance;
+    fileToRename: string | null;
+    fetchFolders: () => Promise<void>;
+    fetchFiles: (folderId?: string) => Promise<void>;
+    handleCreateFolder: () => void;
+    handleModalOk: (currentForm?: FormInstance) => Promise<Folder | undefined>;
+    handleModalCancel: () => void;
+    handleDeleteFile: (fileId: string) => Promise<void>;
+    handleAddFile: () => void;
+    handleFolderSelect: (folderId: string) => void;
+    toggleFileSelection: (fileId: string, opts?: {
+        metaKey?: boolean;
+        ctrlKey?: boolean;
+        shiftKey?: boolean;
+        forceToggle?: boolean;
+    }) => void;
+    handleBreadcrumbClick: (index: number) => void;
+    handleItemClick: (record: File) => void;
+    handleAddFileByUrl: (url?: string | null) => Promise<void>;
+    setIsUrlModalVisible: (visible: boolean) => void;
+    setSearchTerm: (term: string) => void;
+    setSortField: (field: string) => void;
+    setPagination: (pagination: Partial<PaginationState>) => void;
+    generateMenuItems: () => MenuItem[];
+    setPathHistory: (history: PathItem[]) => void;
+    showRenameModal: (fileId: string) => void;
+    handleRenameCancel: () => void;
+    handleRenameOk: () => Promise<void>;
+    handleDroppedFiles: (droppedFiles: globalThis.File[]) => Promise<void>;
+    showMoveModal: () => void;
+    handleMoveCancel: () => void;
+    handleMoveOk: () => Promise<void>;
+}
+interface Counters {
+    optimization_counter: number;
+    ai_counter: number;
+    ai_img_counter: number;
+    ai_generator_limit: number;
+}
+interface Limits {
+    optimization_limit?: number;
+    ai_limit?: number;
+    ai_img_limit?: number;
+    ai_generator_limit?: number;
+}
+export type CustomTheme = Partial<import('antd/es/theme/interface').AliasToken> & {
+    [key: string]: string | number | boolean | undefined;
+};
+/** Варианты комбинированной сортировки в списке файлов (значение Select). */
+export type SortOptionType = 'date-desc' | 'date-asc' | 'size-desc' | 'size-asc' | 'name-asc' | 'name-desc' | 'type-asc';
+export type ProxiedUrlTransitionResult = {
+    src: string | null;
+    changed: boolean;
+    exhausted: boolean;
+    reason: 'unchanged' | 'runtime-update' | 'candidate-fallback' | 'exhausted';
+};
+export type ProxiedUrlDebugSnapshot = {
+    originalUrl: string;
+    resourceType: 'generic' | 'stockImages' | 'stockGifs' | 'stockIcons' | 'emFiles' | 'cdn';
+    intent: 'display' | 'downloadBlob' | 'metadata';
+    stabilityKey?: string;
+    currentSrc: string;
+    runtimeState?: {
+        activeUrl?: string;
+        failedUntil?: number;
+    };
+    candidates: Array<{
+        key: string;
+        url: string;
+        source: 'resource' | 'generic' | 'legacy' | 'direct';
+        isCurrent: boolean;
+        isFailed: boolean;
+        failedUntil?: number;
+    }>;
+};
+export interface Config {
+    theme?: 'light' | 'dark' | 'system';
+    disableMockServer?: boolean;
+    activeTab?: string;
+    showNotifications?: boolean;
+    /**
+     * TTL (мс) подавления повторных одинаковых уведомлений (type + id + data).
+     * 0 — выключить. По умолчанию 12 с, если не задано.
+     */
+    notificationDedupeTtlMs?: number;
+    apiEndpoints?: ApiEndpoints;
+    REACT_APP_GIPHY_KEY?: string;
+    locale?: string;
+    mode?: 'fileManager' | 'imageCenter' | 'plugin';
+    enabledTabs?: string[];
+    iconStrokeWidth?: number;
+    noFilesIconProps?: IconProps;
+    features?: {
+        enableRenameFolder?: boolean;
+        enableRenameFile?: boolean;
+        enableUpdateFile?: boolean;
+        /** Разрешить выбор директорий в диалоге загрузки (webkitdirectory) */
+        enableDirectoryUpload?: boolean;
+        /** Включить вкладку GIF */
+        enableGif?: boolean;
+        /** Включить вкладку stock images */
+        enableStockImages?: boolean;
+        /** Включить вкладку icon stock */
+        enableIconStock?: boolean;
+        /** Включить вкладку генерации QR и штрихкодов */
+        enableQrBarcodeTab?: boolean;
+        /** Включить кнопку/пункт редактирования файла */
+        enableEdit?: boolean;
+        /** Включить перемещение */
+        enableMoveItem?: boolean;
+        enableMoveFolder?: boolean;
+        /** Включить копирование */
+        enableCopyItem?: boolean;
+        enableCopyFolder?: boolean;
+        /** Включить удаление */
+        enableDelete?: boolean;
+    };
+    /**
+     * Library tabs shown with a lock badge instead of being usable — for hosts that gate features
+     * by subscription plan. Clicking a locked tab fires `onLockedTabClick` and does not open it.
+     * Absent or empty: nothing is locked (previous behaviour).
+     */
+    lockedTabs?: LibraryMenuKey[];
+    /** Called when the user clicks a tab listed in `lockedTabs`, e.g. to show an upsell dialog. */
+    onLockedTabClick?: (tab: LibraryMenuKey) => void;
+    dataProcessingMode?: 'server' | 'client' | 'auto';
+    enableClientSideProcessing?: boolean;
+    disablePagination?: boolean;
+    /** При false (или при disablePagination) — пагинации нет в UI и в запросах списка (без page/limit). */
+    hasPagination?: boolean;
+    /** Наличие пагинации на бэкенде (отображение постраничности и т.п.). */
+    paginationAvailable?: boolean;
+    /**
+     * Клиент устраняет дубликаты имён при загрузке, копии из Pixie, URL, batch, copy/move, создании папки.
+     * Отдельно от настроек пагинации (`disablePagination`, `hasPagination`, `paginationAvailable`).
+     */
+    dedupeUploadNamesOnClient?: boolean;
+    /**
+     * Для превью в таблице/плитке разрешить fallback на `file.url` (только изображения),
+     * если миниатюры нет или она загрузилась с ошибкой. По умолчанию включён;
+     * `false` оставляет элемент без превью, пока миниатюра не готова.
+     */
+    previewFallbackToFileUrl?: boolean;
+    /**
+     * Сохранять копию из Pixie в текущую папку исходного файла.
+     * По умолчанию copy-save идёт через `noFolder` во временную папку на стороне хоста.
+     */
+    saveCopyToCurrentFolder?: boolean;
+    enableTrashFolder?: boolean;
+    staticData?: {
+        files?: File[];
+        folders?: Folder[];
+    };
+    customTheme?: CustomTheme;
+    UNSPLASH_KEY?: string;
+    APP_NAME_UNSPLASH?: string;
+    /**
+     * Асинхронный перевод произвольного текста (например RU→EN).
+     * Если задан, вкладка стоковых иконок переводит поисковую строку перед сопоставлением с slug’ами Lucide/Tabler Icons;
+     * локальный словарь (`iconSearchRuLexicon`) дополнительно учитывается по **исходному** запросу.
+     * Реализацию подключает хост: свой бэкенд, Yandex Translate, Google Cloud Translation, DeepL и т.д. (ключи не вшиваются в виджет).
+     */
+    handleTranslate?: (input: string, opts: {
+        locale?: string;
+    }) => Promise<string>;
+    /**
+     * Унифицированный fetch через прокси/ретраи.
+     * Принимает оригинальный URL и должен вернуть готовый `Response`.
+     * `options.intent` позволяет различать display/blob/metadata сценарии.
+     */
+    fetchWithProxy?: (url: string, init?: RequestInit, options?: {
+        intent?: 'display' | 'downloadBlob' | 'metadata';
+    }) => Response | Promise<Response>;
+    /**
+     * Legacy URL resolver for metadata/direct flows. For image display prefer `getProxiedUrl`.
+     * URL перевода для поиска иконок (POST, `Content-Type: application/json`).
+     * Если задан и нет `handleTranslate`, виджет сам вызывает `fetch`: тело `{ text, locale? }`, ответ `{ translatedText }` или `{ text }`.
+     * Запрос уходит только для строк с кириллицей. При 404/ошибке сети поиск продолжается по исходной строке (локальный RU-словарь).
+     */
+    iconStockTranslateUrl?: string;
+    /**
+     * Plugin URL override (PROXY_URL). Возвращает переписанный URL или undefined — тогда
+     * upload/metadata идут через `fetchWithProxy` / `getProxiedUrl`, не через display-default proxy.
+     */
+    handleProxyUrl?: (url: string) => string | null | undefined | Promise<string | null | undefined>;
+    /** Display-controller для `<img src>` через общий proxy runtime-state хоста. */
+    getProxiedUrl?: (url: string) => {
+        src: string;
+        stabilityKey?: string;
+        handleChangeSrc?: () => ProxiedUrlTransitionResult | Promise<ProxiedUrlTransitionResult>;
+        handleSuccess?: () => void | Promise<void>;
+        handleError?: () => ProxiedUrlTransitionResult | Promise<ProxiedUrlTransitionResult>;
+        subscribeToSrcChange?: (listener: (result: ProxiedUrlTransitionResult) => void) => (() => void) | Promise<() => void>;
+        getDebugSnapshot?: () => ProxiedUrlDebugSnapshot | Promise<ProxiedUrlDebugSnapshot>;
+    } | Promise<{
+        src: string;
+        stabilityKey?: string;
+        handleChangeSrc?: () => ProxiedUrlTransitionResult | Promise<ProxiedUrlTransitionResult>;
+        handleSuccess?: () => void | Promise<void>;
+        handleError?: () => ProxiedUrlTransitionResult | Promise<ProxiedUrlTransitionResult>;
+        subscribeToSrcChange?: (listener: (result: ProxiedUrlTransitionResult) => void) => (() => void) | Promise<() => void>;
+        getDebugSnapshot?: () => ProxiedUrlDebugSnapshot | Promise<ProxiedUrlDebugSnapshot>;
+    }>;
+    /** Хендлер проксирования бинарного файла: принимает внешний URL и возвращает Blob. */
+    handleFileProxy?: (url: string) => Blob | Promise<Blob>;
+    pushToGTM?: boolean;
+    projectId?: string;
+    elementId?: string;
+    baseUrl?: string;
+    assetsUrl?: string;
+    /** Counters and limits */
+    counters?: Counters;
+    limits?: Limits;
+    /** billing page url */
+    billingPageUrl?: string;
+    notification?: void;
+    sendAIImageRequest?: (params: object) => Promise<unknown>;
+    sseQuery?: (params: object) => void;
+    customLocale?: object;
+    activeLibraryItem?: LibraryMenuKey;
+    fileForEdit?: string;
+    messages?: MessageType[];
+    handleLimitUsageEmitter?: {
+        fire: (args: object) => void;
+    };
+    folderTreeLoading?: 'lazy' | 'eager';
+    expandAllFoldersOnInit?: boolean;
+    /** Разворачивать только корневую папку на старте (без дочерних) */
+    expandRootFolderOnInit?: boolean;
+    /** Запоминать последнюю открытую папку между сессиями */
+    rememberLastFolder?: boolean;
+    compressMaxSize?: number;
+    compressMaxWidthOrHeight?: number;
+    /** URL локальной копии browser-image-compression для web worker. */
+    compessorUrl?: string;
+    /** Alias для compessorUrl с корректным написанием. */
+    compressorUrl?: string;
+    multiSelect?: boolean;
+    /** Белый список сортировок для отображения в дропдауне. Если не указан — доступны все. */
+    sortOptions?: SortOptionType[];
+    defaultFolderName?: string;
+    availableImageExtensions?: Array<(typeof IMAGE_EXTENSIONS)[number]>;
+    /** Настройки обработки имен файлов при загрузке */
+    fileNameProcessing?: {
+        transliterate?: boolean;
+        replaceSpaces?: boolean;
+        removeForbiddenChars?: boolean;
+        toLowerCase?: boolean;
+    };
+    /** Настройки обработки имен папок при создании */
+    folderNameProcessing?: {
+        transliterate?: boolean;
+        replaceSpaces?: boolean;
+        removeForbiddenChars?: boolean;
+        toLowerCase?: boolean;
+    };
+    /** Контейнер для рендера полноэкранного drop overlay (при интеграции в Shadow DOM / модалках) */
+    getDropOverlayContainer?: () => HTMLElement;
+    /** Разрешаем произвольные дополнительные поля */
+    [key: string]: unknown;
+}
+export type LibraryMenuKey = typeof MY_FILES | typeof GIF | typeof STOCK_IMAGES | typeof ICONS | typeof AI | typeof IMAGE_CODES | typeof EDITOR;
+export interface ImageCodeGeneratorState {
+    mode: 'qr' | 'barcode';
+    rawText: string;
+    foregroundHex: string;
+    backgroundHex: string;
+    transparentBackground: boolean;
+    qrSidePx: number;
+    barcodeBarHeightPx: number;
+}
+export interface ImageCodeGeneratorProps {
+    customRequest: (args: {
+        file: globalThis.File;
+    }) => Promise<void | File>;
+    state: ImageCodeGeneratorState;
+    setState: React.Dispatch<React.SetStateAction<ImageCodeGeneratorState>>;
+}
+/** Строка в сетке вкладки иконок (Lucide / Iconify). `hash` — id вида `lucide:icon-name`. */
+export type StreamlineSearchItem = {
+    hash: string;
+    name: string;
+    imagePreviewUrl: string;
+    isFree: boolean;
+    familySlug: string;
+    familyName: string;
+    categorySlug?: string;
+    categoryName?: string;
+    subcategorySlug?: string;
+    subcategoryName?: string;
+};
+export interface IconsTabProps {
+    /** @deprecated Не используется (иконки встроены). */
+    apiKey?: string;
+    customRequest: (data: string) => void | Promise<void>;
+    query?: string;
+    setQuery?: (query: string) => void;
+    inputRef?: React.RefObject<InputRef | null>;
+}
+export interface GifItem {
+    id: string;
+    title: string;
+    images: {
+        downsized: {
+            url: string;
+            width?: string;
+            height?: string;
+        };
+        fixed_width?: {
+            url: string;
+            width?: string;
+            height?: string;
+        };
+        fixed_width_downsampled?: {
+            url: string;
+            width?: string;
+            height?: string;
+        };
+    };
+}
+export interface CurrentReqGif {
+    keywords: string;
+}
+export interface ImageGifProps {
+    setImageGifList: React.Dispatch<React.SetStateAction<GifItem[]>>;
+    imageGifList: GifItem[];
+    currentReqGif: CurrentReqGif;
+    setCurrentReqGif: React.Dispatch<React.SetStateAction<CurrentReqGif>>;
+    inputRef: React.RefObject<InputRef | null>;
+    customRequest: (data: string, fileName?: string) => Promise<File | void> | void;
+}
+export interface UnsplashImage {
+    id: string;
+    width?: number;
+    height?: number;
+    description: string;
+    urls: {
+        raw: string;
+        small: string;
+    };
+    links: {
+        download_location: string;
+    };
+    user: {
+        name: string;
+        links: {
+            html: string;
+        };
+    };
+}
+export interface CurrentReqStock {
+    keywords: string;
+    color: string;
+    orientation: string;
+}
+export interface ImageStockProps {
+    imageStockList: UnsplashImage[];
+    setImageStockList: React.Dispatch<React.SetStateAction<UnsplashImage[]>>;
+    currentReq: CurrentReqStock;
+    setCurrentReq: React.Dispatch<React.SetStateAction<CurrentReqStock>>;
+    inputRef: React.RefObject<InputRef | null>;
+    customRequest: (data: string, fileName?: string) => Promise<File | void> | void;
+}
+export interface ImageAIProps {
+    customRequest: (file: {
+        file: globalThis.File;
+    }) => Promise<void | File>;
+    inputAiRef: RefObject<TextAreaRef | null>;
+    isImageUploaded: boolean;
+    setIsImageUploaded: (val: boolean) => void;
+    aiImageRequest: string;
+    setAiImageRequest: React.Dispatch<React.SetStateAction<string>>;
+    imageAiList: string[];
+    setImageAiList: React.Dispatch<React.SetStateAction<string[]>>;
+    isLoadingAi: boolean;
+    setIsLoadingAi: React.Dispatch<React.SetStateAction<boolean>>;
+}
+export interface ArrowProps {
+    className?: string;
+    onClick?: () => void;
+}
+export interface UseImageAIGenerationProps {
+    setFrameHeight: React.Dispatch<React.SetStateAction<string | number>>;
+    customRequest: (args: {
+        file: globalThis.File;
+    }) => void;
+    aiTabRef: React.RefObject<HTMLElement | null>;
+    isImageUploaded: boolean;
+    setIsImageUploaded: (val: boolean) => void;
+    aiImageRequest: string;
+    imageAiList: string[];
+    setImageAiList: React.Dispatch<React.SetStateAction<string[]>>;
+    isLoadingAi: boolean;
+    setIsLoadingAi: React.Dispatch<React.SetStateAction<boolean>>;
+}
+export interface UseImageAIGenerationReturn {
+    aiImageCounter: number;
+    setAiImageCounter: React.Dispatch<React.SetStateAction<number>>;
+    currentAiImgLimits: number;
+    isFieldsDisabled: boolean;
+    canGenerateImage: boolean;
+    aiImageRequest: string;
+    imageAiList: string[];
+    setImageAiList: React.Dispatch<React.SetStateAction<string[]>>;
+    isLoadingAi: boolean;
+    setIsLoadingAi: React.Dispatch<React.SetStateAction<boolean>>;
+    loadingDuringGeneration: boolean;
+    setLoadingDuringGeneration: React.Dispatch<React.SetStateAction<boolean>>;
+    requestStatus: string;
+    setRequestStatus: React.Dispatch<React.SetStateAction<string>>;
+    handleGenerate: () => void;
+    handleLimitAiImgCount: () => void;
+    convertBase64ToFile: (source: string) => Promise<void>;
+    isShiftPressed: boolean;
+    setIsShiftPressed: React.Dispatch<React.SetStateAction<boolean>>;
+    currentReqId: string | null;
+    setCurrentReqId: React.Dispatch<React.SetStateAction<string | null>>;
+    limitsInPlugin: boolean;
+}
+export type MessageType = {
+    status?: string;
+    images?: unknown[];
+    progress?: number;
+    data?: unknown;
+    [key: string]: unknown;
+};
+export interface FileManagerProps {
+    config?: Config;
+    currentPath?: string;
+    onPathChange?: (path: string[]) => void;
+    onChangeSelection?: (files: File[]) => void;
+    onEditorOk?: (file: {
+        id: string;
+        folderId: string | undefined;
+        name: string;
+    }, meta?: EditorSaveMeta) => void;
+    searchQuery?: string;
+    sortBySize?: string;
+    dataProviders?: FileManagerDataProviders;
+    apiEndpoints?: {
+        getFolders?: string;
+        getFiles?: string;
+        createFolder?: string;
+        deleteFolder?: string;
+        addFile?: string;
+        deleteFile?: string;
+        renameFile?: string;
+        moveFile?: string;
+        updateFile?: string;
+        clearCache?: string;
+    };
+    customIcons?: CustomIcons;
+    dragDropIcon?: string;
+    handleNotify?: NotifyListener<NotifyEvent>;
+    handleError?: NotifyListener<Notify.ErrorEvent>;
+    handleSuccess?: NotifyListener<Notify.SuccessEvent>;
+}
+export interface SafeImageProps {
+    thumbnailSrc?: string;
+    previewSrc?: string;
+    lightboxSrc?: string;
+    alt: string;
+    className?: string;
+    width?: number;
+    height?: number;
+    preview?: boolean;
+    file?: File;
+    getFileData?: (fileId: string, silent?: boolean) => Promise<Blob | undefined>;
+}