@emailmaker/emailmaker 1.1.65 → 1.1.69

package/file-manager/utils/aiImageSource.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Картинка от ИИ может быть «голым» base64 (наш встроенный генератор) либо ссылкой/data-URI
+ * (сторонний ИИ хоста в закрытом контуре). Для отрисовки достаточно достроить data-URI только
+ * у голого base64; для получения Blob — понять, нужно ли качать значение через fetch (он умеет
+ * как http(s)-ссылки, так и data:-URI любой кодировки, включая некодированный SVG).
+ */
+/** Есть ли у значения схема URI (http(s)://, protocol-relative //, data:). */
+export declare function hasUriScheme(value: string): boolean;
+/** Значение, пригодное для `src` у `<img>`. */
+export declare function toAiImageSrc(value: string): string;

package/file-manager/utils/aiImageSource.test.d.ts

@@ -0,0 +1 @@
+export {};

package/file-manager/utils/blobUtils.d.ts

@@ -0,0 +1 @@
+export declare const ensureBlobFromData: (data: Blob | string, fallbackMimeType?: string) => Blob;

package/file-manager/utils/cacheClear.d.ts

@@ -0,0 +1,8 @@
+import { FileManagerDataProviders, FileManagerOptions, PathItem } from '../types';
+export declare const resolveCachePathForError: (error: unknown, pathHistory: PathItem[]) => string;
+export declare const getPathFromHistory: (pathHistory: PathItem[]) => string;
+export declare const clearFolderCache: (params: {
+    options: FileManagerOptions;
+    pathFolder: string;
+    dataProviders?: FileManagerDataProviders;
+}) => Promise<void>;

package/file-manager/utils/dedupeUploadNamesOnClient.d.ts

@@ -0,0 +1,6 @@
+import type { Config } from '../types';
+/**
+ * Флаг `Config.dedupeUploadNamesOnClient`: клиент подбирает уникальные имена при загрузке,
+ * копии из Pixie, upload по URL, batch, copy/move, создании папки.
+ */
+export declare function isDedupeUploadNamesOnClientEnabled(config?: Pick<Config, 'dedupeUploadNamesOnClient'>): boolean;

package/file-manager/utils/directResourceFetchError.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Detects a final direct-fetch failure from the host resource proxy engine.
+ * Uses error.name for cross-package compatibility (no instanceof across bundles).
+ */
+export declare function isFinalDirectResourceFetchError(error: unknown): boolean;

package/file-manager/utils/directResourceFetchError.test.d.ts

@@ -0,0 +1 @@
+export {};

package/file-manager/utils/errorMessages.d.ts

@@ -0,0 +1,49 @@
+import type { FileManageErrorInfo, FileManagerErrorCode } from 'notification';
+type TFunction = (key: string, params?: Record<string, unknown>) => string;
+export interface ErrorMessageParams {
+    allowedChars?: string;
+    fileSize?: string;
+    maxSize?: string;
+}
+/**
+ * Возвращает локализованное сообщение по коду ошибки, если для него есть i18n-ключ.
+ * Поддерживает параметры для шаблонов: allowedChars, fileSize, maxSize.
+ */
+export declare const getErrorMessageFromCode: (code: FileManagerErrorCode | undefined, t: TFunction, params?: ErrorMessageParams) => string | undefined;
+/**
+ * Пытается определить более точный код ошибки по тексту сообщения бэкенда.
+ * Используется когда бэкенд возвращает ValidationError/BackendError с информативным сообщением.
+ */
+export declare const inferErrorCodeFromMessage: (message: string | undefined) => FileManagerErrorCode | undefined;
+/**
+ * Определяет код ошибки по тексту сообщения для контекста загрузки по URL.
+ * 403/forbidden при загрузке по URL = внешний ресурс недоступен (UploadUrlNotReachable).
+ */
+export declare const inferErrorCodeFromMessageForUrlUpload: (message: string | undefined) => FileManagerErrorCode | undefined;
+/**
+ * Пытается извлечь IFileManagerApiError из unknown.
+ */
+export declare const asFileManagerApiError: (error: unknown) => FileManageErrorInfo;
+/** Ключ для сообщения о размере файла с параметрами */
+export declare const FILE_TOO_LARGE_WITH_SIZE_KEY = "File too large ({{size}}). Maximum allowed size: {{maxSize}}";
+/** Ключ для превышения лимита файлов в батче (allowed, received) */
+export declare const BATCH_ITEM_LIMIT_EXCEEDED_WITH_COUNT_KEY = "Maximum number of files exceeded. Allowed: {{allowed}}, received: {{received}}";
+/**
+ * Возвращает сообщение об ошибке для отображения при загрузке.
+ * Поддерживает параметры для FileTooLarge (size, maxSize) и BatchItemLimitExceeded/exceeded_max_files (allowed, received).
+ */
+export declare const getUploadErrorMessage: (error: unknown, t: TFunction, context?: {
+    fileSize?: number;
+    maxSize?: number;
+}) => string;
+/**
+ * Проверяет, что ошибка — path_folder_not_found (папка уже не существует).
+ * При удалении это считается успехом — цель достигнута.
+ */
+export declare const isPathFolderNotFoundError: (error: unknown) => boolean;
+/**
+ * Возвращает сообщение для отображения при ошибке загрузки по URL.
+ * Приоритет: код ошибки → понятное сообщение бэкенда → общий fallback.
+ */
+export declare const getUploadByUrlErrorMessage: (apiError: FileManageErrorInfo | undefined, t: TFunction, params?: ErrorMessageParams) => string;
+export {};

package/file-manager/utils/fileFormatUtils.d.ts

@@ -0,0 +1,44 @@
+export type ImageFormat = 'jpeg' | 'png' | 'gif' | 'webp' | 'svg';
+export type PixieFormat = 'jpeg' | 'png' | 'json' | 'svg';
+export interface FileFormatInfo {
+    extension: string;
+    mimeType: string;
+    format: ImageFormat;
+    pixieFormat: PixieFormat;
+}
+/**
+ * Определяет формат файла из нескольких источников с правильным приоритетом
+ * @param file - Объект файла с возможными полями name, extension, type
+ * @param fallbackType - Запасной MIME-тип если не удалось определить из файла
+ * @returns Информация о формате файла
+ */
+export declare function detectFileFormat(file: {
+    name?: string;
+    extension?: string;
+    type?: string;
+} | null, fallbackType?: string): FileFormatInfo;
+/**
+ * Константы для сжатия изображений
+ */
+export declare const IMAGE_COMPRESSION_DEFAULTS: {
+    readonly MAX_SIZE_MB: 0.48;
+    readonly MAX_WIDTH_OR_HEIGHT: 2000;
+    readonly QUALITY: 0.8;
+};
+/**
+ * Поддерживаемые форматы изображений
+ */
+export declare const SUPPORTED_IMAGE_FORMATS: readonly ['jpg', 'jpeg', 'png', 'gif', 'webp', 'svg'];
+/**
+ * Форматы, которые не нужно сжимать
+ */
+export declare const NON_COMPRESSIBLE_FORMATS: readonly ['gif', 'svg'];
+/**
+ * Проверяет, нужно ли сжимать файл данного формата
+ */
+export declare function shouldCompressFormat(format: string): boolean;
+export interface ImageCompressionConfig {
+    compressMaxSize?: number;
+    compressMaxWidthOrHeight?: number;
+}
+export declare function shouldEnableImageCompression(config: ImageCompressionConfig | undefined, mimeType: string | undefined): boolean;

package/file-manager/utils/fileValidation.d.ts

@@ -0,0 +1,58 @@
+export declare const MAX_FILE_SIZE: number;
+export declare const MIN_FILE_SIZE = 1;
+export declare const ALLOWED_FILE_TYPES: {
+    images: string[];
+    documents: string[];
+    archives: string[];
+    videos: string[];
+    audio: string[];
+};
+export declare const ALL_ALLOWED_TYPES: string[];
+export interface FileValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings?: string[];
+}
+export interface FileValidationOptions {
+    maxSize?: number;
+    minSize?: number;
+    allowedTypes?: string[];
+    allowAllTypes?: boolean;
+    maxFileNameLength?: number;
+}
+export declare const validateFile: (file: File, options?: FileValidationOptions) => FileValidationResult;
+export declare const validateFiles: (files: File[], options?: FileValidationOptions) => {
+    valid: File[];
+    invalid: {
+        file: File;
+        result: FileValidationResult;
+    }[];
+};
+export declare const validateFileUrl: (url: string) => Promise<FileValidationResult>;
+export declare const getFileCategory: (file: File) => string;
+export declare const formatFileSize: (bytes: number) => string;
+export declare const formatFileSizeShort: (bytes?: number) => string;
+export declare const formatFileSizeDisplay: (value?: number | string) => string;
+/**
+ * Генерирует уникальное имя файла: если name уже есть в existingNames, добавляет _1 (или _2, _3 и т.д.).
+ * @param name — исходное имя файла (с расширением)
+ * @param existingNames — массив имён файлов/папок в целевой директории
+ */
+export declare const getUniqueFileName: (name: string, existingNames: string[]) => string;
+/**
+ * Кодирует URL для безопасного использования в img src. Решает проблему с кириллицей и другими
+ * не-ASCII символами в пути (например, emcdn.ru/.../Снимок_экрана.png).
+ * data: и blob: URLs возвращаются без изменений.
+ */
+export declare const encodeUrlForImageSrc: (url: string | undefined | null) => string | undefined;
+/**
+ * @deprecated Эта функция оставлена только для обратной совместимости.
+ * Используйте {@link normalizeFileName} из `nameNormalization.ts` для настраиваемой нормализации имен файлов.
+ *
+ * Упрощенная санитизация имени файла:
+ * - Заменяет запрещенные символы на `_`
+ * - Заменяет пробелы на `_`
+ * - Удаляет множественные подчеркивания
+ * - Ограничивает длину до 255 символов
+ */
+export declare const sanitizeFileName: (fileName: string) => string;

package/file-manager/utils/iconCssVars.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CSS-переменные раскраски иконок (`--em-icon-color-1` и подобные).
+ *
+ * Имена в исходниках пишутся без бренд-префикса, его проставляет трансформ сборки. Но видит он
+ * только строковые литералы и шаблоны — имя внутри regex-литерала (`/var\(--icon-color-2\)/`)
+ * остаётся непрефиксованным и перестаёт совпадать с тем, что реально попало в SVG. Поэтому
+ * регулярные выражения строим здесь, из того же правила префикса.
+ */
+/** `var(--em-icon-color-1)` — ссылка на переменную. */
+export declare function iconVarRef(name: string): string;
+/** Регулярное выражение на такую же ссылку. */
+export declare function iconVarRefPattern(name: string, flags?: string): RegExp;

package/file-manager/utils/imageCache.d.ts

@@ -0,0 +1,10 @@
+export declare const getCachedImage: (fileId: string) => string | undefined;
+export declare const setCachedImage: (fileId: string, imageData: string) => void;
+export declare const hasCachedImage: (fileId: string) => boolean;
+export declare const getImageCacheStats: () => {
+    size: number;
+    maxSize: number;
+    cleanupBatchSize: number;
+    usage: number;
+};
+export declare const clearImageCache: () => void;

package/file-manager/utils/imageCompression.d.ts

@@ -0,0 +1,12 @@
+export interface PrepareImageForUploadOptions {
+    maxSizeMB?: number;
+    maxWidthOrHeight?: number;
+    mimeType?: string;
+    fileName?: string;
+    libURL?: string;
+    enableCompression?: boolean;
+    /** Только для загрузки в файловый менеджер: SVG → PNG до остальной обработки. Не использовать при экспорте SVG из редактора. */
+    convertSvgToPng?: boolean;
+}
+export declare function prepareImageForUpload(file: File, options?: PrepareImageForUploadOptions): Promise<File>;
+export declare const compressImageWithLimits: typeof prepareImageForUpload;

package/file-manager/utils/isAntImagePreviewClick.d.ts

@@ -0,0 +1 @@
+export declare const isAntImagePreviewClick: (target: HTMLElement) => boolean;

package/file-manager/utils/isImageEligibleForEditorInsert.d.ts

@@ -0,0 +1,3 @@
+import type { File as AppFile } from '../types';
+/** Те же критерии, что у кнопки «Выбрать» в режиме вставки в шаблон. */
+export declare function isImageEligibleForEditorInsert(file: AppFile): boolean;

package/file-manager/utils/jsonDataProvider.d.ts

@@ -0,0 +1,89 @@
+import { FileManagerDataProviders, File, FileManagerItemMeta, Folder, Config, UploadFilesRequest, UploadFileResultData, BatchResult, UploadBinary } from '../types';
+export declare class JSONDataProvider implements FileManagerDataProviders {
+    private files;
+    private folders;
+    constructor(config?: Config);
+    loadFromJSON: (data: {
+        files?: File[];
+        folders?: Folder[];
+    }) => void;
+    loadFromURL: (url: string) => Promise<void>;
+    addFiles: (newFiles: File[]) => void;
+    addFolders: (newFolders: Folder[]) => void;
+    private normalizeComparableUrl;
+    getFileData: (fileId: string) => Promise<Blob>;
+    getItem: (id: string) => Promise<FileManagerItemMeta | null>;
+    findFileByUrl: (url: string) => Promise<File | null>;
+    getFolders: (options?: {
+        parentId?: string | null;
+        deep?: boolean;
+    }) => Promise<Folder[]>;
+    getFiles: (options?: {
+        folderId?: string;
+        noFolder?: boolean;
+        search?: string;
+        sortBy?: 'name' | 'size' | 'date' | 'type';
+        sortOrder?: 'asc' | 'desc';
+        itemType?: 'file' | 'folder' | 'all';
+    }) => Promise<{
+        files: File[];
+        total: number;
+    }>;
+    createFolder: (data: {
+        name: string;
+        parentId?: string | null;
+    }) => 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;
+        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>;
+    updateFile: (fileId: string, updates: {
+        name?: string;
+        type?: string;
+        data?: UploadBinary;
+        thumbnail?: string;
+        dimensions?: string;
+        aspectRatio?: string;
+        extension?: string;
+    }) => Promise<File>;
+    deleteFile: (fileId: string) => Promise<boolean>;
+    cleanTrash: () => Promise<{
+        success: boolean;
+        deletedCount?: number;
+    }>;
+    renameFile: (fileId: string, newName: string) => Promise<File>;
+    moveItem: (options: {
+        itemId: string;
+        targetFolderId: string;
+        isFolder: boolean;
+    }) => Promise<boolean>;
+    private getFileTypeFromExtension;
+    exportToJSON: () => {
+        files: File[];
+        folders: Folder[];
+    };
+    clear: () => void;
+    getStats: () => {
+        totalFiles: number;
+        totalFolders: number;
+        filesByType: Record<string, number>;
+    };
+}

package/file-manager/utils/libraryTabLock.d.ts

@@ -0,0 +1,11 @@
+import type { LibraryMenuKey } from '../types';
+/** Subset of the file manager config that controls locked library tabs. */
+export interface LibraryTabLockConfig {
+    /**
+     * Tabs the host wants shown with a lock badge instead of being usable, e.g. when the user's
+     * plan does not include stock images. Absent or empty list means nothing is locked, so hosts
+     * that never set it keep the previous behaviour.
+     */
+    lockedTabs?: LibraryMenuKey[];
+}
+export declare function isLibraryTabLocked(tab: LibraryMenuKey, config: LibraryTabLockConfig | undefined): boolean;

package/file-manager/utils/libraryTabLock.test.d.ts

@@ -0,0 +1 @@
+export {};

package/file-manager/utils/mapWithConcurrency.d.ts

@@ -0,0 +1 @@
+export declare function mapWithConcurrency<T, R>(items: readonly T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;

package/file-manager/utils/mimeUtils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Нормализует MIME-тип изображения до стандартного формата
+ * @param mimeType - MIME-тип для нормализации
+ * @returns Нормализованный MIME-тип
+ */
+export declare const normalizeImageMimeType: (mimeType: string) => string;
+/**
+ * Извлекает MIME-тип из data URL
+ * @param dataUrl - Data URL строка
+ * @returns MIME-тип или null если не найден
+ */
+export declare const extractMimeFromDataUrl: (dataUrl: string) => string | null;
+/**
+ * Нормализует MIME тип изображения на основе данных thumbnail и типа файла
+ * @param thumbnail - Данные изображения (может быть data URL)
+ * @param fileType - Исходный тип файла
+ * @returns Нормализованный MIME тип
+ */
+export declare const normalizeMimeType: (thumbnail: string, fileType?: string) => string;
+/**
+ * Извлекает расширение файла из MIME типа
+ * @param mimeType - MIME тип
+ * @returns Расширение файла (png, jpg, gif и т.д.)
+ */
+export declare const getExtensionFromMime: (mimeType: string) => string;
+/**
+ * MIME по расширению имени (когда у File пустой или неверный type).
+ */
+export declare function inferImageMimeFromFileName(fileName: string): string | undefined;
+/**
+ * Файл допускается в пайплайн загрузки изображений (в т.ч. SVG с application/octet-stream или пустым type).
+ */
+export declare function isAllowedImageUploadFile(file: {
+    name?: string;
+    type?: string;
+}): boolean;

package/file-manager/utils/nameNormalization.d.ts

@@ -0,0 +1,24 @@
+import { Config } from '../types';
+/**
+ * Настройки обработки имени по умолчанию
+ */
+export interface NameProcessingOptions {
+    transliterate?: boolean;
+    replaceSpaces?: boolean;
+    removeForbiddenChars?: boolean;
+    toLowerCase?: boolean;
+}
+/**
+ * Транслитерирует кириллицу в латиницу.
+ * NFC: «й» в NFD — это и + combining breve; без нормализации получится «ĭ» вместо «y».
+ */
+export declare function transliterateRuToEn(text: string): string;
+/**
+ * Нормализует имя файла с учетом настроек из конфига
+ * Сохраняет оригинальное расширение файла
+ */
+export declare function normalizeFileName(fileName: string, config?: Config): string;
+/**
+ * Нормализует имя папки с учетом настроек из конфига
+ */
+export declare function normalizeFolderName(folderName: string, config?: Config): string;

package/file-manager/utils/remoteFileFetchPipeline.d.ts

@@ -0,0 +1,25 @@
+export type RemoteFileFetchIntent = 'display' | 'downloadBlob' | 'metadata';
+export type RemoteFileFetchHandlers = {
+    fetchWithProxy?: (url: string, init?: RequestInit, options?: {
+        intent?: RemoteFileFetchIntent;
+    }) => Response | Promise<Response>;
+    handleFileProxy?: (url: string) => Blob | Promise<Blob | null | undefined>;
+    handleProxyUrl?: (url: string) => string | null | undefined | Promise<string | null | undefined>;
+};
+export type FetchBlobFromUrl = (url: string) => Promise<Blob>;
+export type ValidateImageBlobResult = {
+    blob: Blob;
+    mimeType: string;
+};
+export type ValidateImageBlob = (blob: Blob) => ValidateImageBlobResult;
+export type FetchRemoteImageBlobOptions = {
+    fetchInit?: RequestInit;
+};
+/**
+ * ADR-aligned blob fetch ladder for upload-by-URL:
+ * 1. handleFileProxy (plugin Blob)
+ * 2. handleProxyUrl → fetch rewritten URL (outside engine)
+ * 3. fetchWithProxy (host engine / policy v2)
+ * 4. direct fetch — only without `fetchWithProxy` (engine already includes direct fallback in its chain)
+ */
+export declare function fetchRemoteImageBlobByUrl(normalizedUrl: string, handlers: RemoteFileFetchHandlers, fetchBlobFromUrl: FetchBlobFromUrl, validateImageBlob: ValidateImageBlob, options?: FetchRemoteImageBlobOptions): Promise<ValidateImageBlobResult>;

package/file-manager/utils/remoteFileFetchPipeline.test.d.ts

@@ -0,0 +1 @@
+export {};

package/file-manager/utils/resizeObserverHandler.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Утилита для подавления ошибок ResizeObserver
+ * Эти ошибки часто возникают при работе с модальными окнами и динамическими компонентами
+ */
+export declare const installResizeObserverErrorHandler: () => void;
+export declare const uninstallResizeObserverErrorHandler: () => void;

package/file-manager/utils/resolveItemMeta.d.ts

@@ -0,0 +1,9 @@
+import type { TFunction } from 'i18next';
+import type { FileManagerDataProviders, Folder, PathItem } from '../types';
+export declare function resolveFolderDisplayName(opts: {
+    folderId: string | null | undefined;
+    dataProviders?: FileManagerDataProviders;
+    folders?: Folder[];
+    pathHistory?: PathItem[];
+    t: TFunction;
+}): Promise<string>;

package/file-manager/utils/resolveUniqueUploadName.d.ts

@@ -0,0 +1,7 @@
+import type { FileManagerDataProviders } from '../types';
+type UploadNameProvider = Pick<FileManagerDataProviders, 'getFiles' | 'getFolders'>;
+/**
+ * Уникальное имя файла в папке (клиент), если включён `Config.dedupeUploadNamesOnClient`.
+ */
+export declare function resolveUniqueUploadNameWithProvider(dataProviders: UploadNameProvider | undefined, originalName: string, folderId?: string | null, noFolder?: boolean, dedupeUploadNamesOnClient?: boolean): Promise<string>;
+export {};

package/file-manager/utils/sortHelpers.d.ts

@@ -0,0 +1,3 @@
+import { File } from '../types';
+export declare const sortFiles: (files: File[], sortBy?: 'name' | 'size' | 'date' | 'type', sortOrder?: 'asc' | 'desc') => File[];
+export declare const filterFiles: (files: File[], searchTerm: string) => File[];

package/file-manager/utils/svgParseUtils.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Утилиты для парсинга SVG: определение количества цветов, толщины линий и стиля иконок.
+ * Поддерживает атрибуты и inline style, градиенты (linear и radial), различные форматы цветов.
+ */
+/** Конвертирует цвет в hex для ColorPicker (rgb, rgba, имя → #rrggbb) */
+export declare function colorToHex(raw: string): string;
+/** Нормализует цвет к hex для сравнения (без учёта прозрачности для уникальности) */
+export declare function normalizeColorForCompare(raw: string): string | null;
+export interface SvgParseResult {
+    /** Уникальные цвета (fill/stroke/stop-color) */
+    colors: string[];
+    /** Количество элементов с fill */
+    fillsCount: number;
+    /** Количество элементов с stroke */
+    strokesCount: number;
+    /** Есть градиенты */
+    hasGradient: boolean;
+    /** Извлечённый stroke-width или undefined */
+    strokeWidth: number | undefined;
+}
+/** Парсит SVG и возвращает метаданные для определения стиля family */
+export declare function parseSvgForFamily(svg: string): SvgParseResult;
+/** Агрегирует результаты по нескольким SVG */
+export declare function aggregateSvgParseResults(results: SvgParseResult[]): SvgParseResult;
+/**
+ * Строит карту: нормализованный цвет → индекс переменной (1, 2, 3...).
+ * Порядок — по первому появлению цвета (сначала svg, затем shape-элементы).
+ */
+export declare function buildFillColorToVarIndexMap(svg: string): Map<string, number>;
+/**
+ * Единая карта цветов: fill и stroke в порядке появления.
+ * Используется для правильного отображения обводки (stroke) как отдельного цвета.
+ */
+export declare function buildUnifiedColorToVarIndexMap(svg: string): Map<string, number>;
+/** Аналогично для stroke. Учитывает stroke на <svg> — наследуется paths. */
+export declare function buildStrokeColorToVarIndexMap(svg: string): Map<string, number>;
+/**
+ * Извлекает цвета из SVG в том же порядке, что и buildUnifiedColorToVarIndexMap.
+ * Возвращает [color1, color2, color3] — сырые значения для пикеров.
+ */
+export declare function extractColorsInUnifiedOrder(svg: string): string[];
+/** Извлекает цвета для установки в пикеры (stops, fills, strokes по приоритету) */
+export declare function extractColorsForPickers(svg: string): {
+    fills: string[];
+    strokes: string[];
+    stops: string[];
+};

package/file-manager/utils/svgToPng.d.ts

@@ -0,0 +1,52 @@
+export type SvgColorOptions = {
+    colorHex: string;
+    colorHex2: string;
+    colorHex3: string;
+};
+export declare function applyInlineColors(svg: string, colors: SvgColorOptions): string;
+export declare function computeSvgTargetDimensions(svgText: string, targetSize: number): {
+    width: number;
+    height: number;
+};
+/**
+ * «Логические» пиксели SVG: width/height на <svg> (если заданы в px/числе), иначе размеры из viewBox.
+ */
+export declare function getSvgIntrinsicDimensions(svgText: string): {
+    width: number;
+    height: number;
+};
+/**
+ * Размер PNG при загрузке: intrinsic × pixelScale (по умолчанию 2× к width/height SVG), с ограничением длинной стороны.
+ */
+export declare function computeSvgUploadPngDimensions(svgText: string, pixelScale?: number, maxLongEdge?: number): {
+    width: number;
+    height: number;
+};
+export type RasterizeSvgToPngOptions = {
+    /** Доп. масштаб canvas (для ретины в UI иконок; при загрузке файлов обычно 1). */
+    canvasScale?: number;
+};
+/**
+ * Растеризация SVG → PNG (без data URL / fetch — надёжнее для больших SVG).
+ */
+export declare function rasterizeSvgTextToPngBlob(svgText: string, outW: number, outH: number, bg?: string, rasterOpts?: RasterizeSvgToPngOptions): Promise<Blob>;
+export declare function rasterizeSvgToPng(svgText: string, outW: number, outH: number, bg?: string, rasterOpts?: RasterizeSvgToPngOptions): Promise<string>;
+/** Первые байты файла как UTF-8 текст (для определения SVG без расширения .svg). */
+export declare function readFileTextHead(file: File, maxBytes?: number): Promise<string>;
+/** Начало похоже на SVG-разметку (в т.ч. после <?xml). */
+export declare function looksLikeSvgMarkup(text: string): boolean;
+export interface ConvertSvgFileToPngOptions {
+    /**
+     * Множитель к логическим width/height SVG (из атрибутов или viewBox).
+     * По умолчанию 2 — итоговая ширина PNG ≈ 2× width в разметке.
+     */
+    pixelScale?: number;
+    /** Верхняя граница длинной стороны PNG после pixelScale (страховка от гигантских SVG). */
+    maxLongEdge?: number;
+    /** Базовое имя файла (уже нормализованное), будет заменено .svg → .png */
+    outputFileName?: string;
+}
+/**
+ * Растеризация загружаемого SVG в PNG: размер = intrinsic × pixelScale (по умолчанию 2×), без лишнего ×2 на canvas.
+ */
+export declare function convertSvgFileToPngFile(file: File, options?: ConvertSvgFileToPngOptions): Promise<File>;

package/file-manager/utils/svgToPng.test.d.ts

@@ -0,0 +1 @@
+export {};

package/file-manager/utils/themeUtils.d.ts

@@ -0,0 +1,8 @@
+import { Config } from '../types';
+export declare const switchThemeVariables: (token?: {}) => void;
+/** Применяет кастомную тему к CSS переменным */
+export declare const applyCustomTheme: (config?: Config) => void;
+/** Устанавливает тему (светлая/темная) */
+export declare const setTheme: (theme: 'light' | 'dark' | 'system') => void;
+/** Получает текущую тему */
+export declare const getCurrentTheme: () => 'light' | 'dark';

package/file-manager/utils/urlNormalization.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Нормализует внешний URL для детерминированного поиска файла по источнику.
+ * Убирает hash, трекинговые query-параметры, нормализует host и сортирует query.
+ */
+export declare function normalizeExternalFileUrl(url: string): string;
+/**
+ * Совпадает ли origin URL с текущей страницей (protocol + host + port).
+ * Для same-origin прокси не используем — загрузка напрямую.
+ */
+export declare function isUrlSameOriginAsCurrentPage(url: string): boolean;

package/file-manager/utils/urlValidation.d.ts

@@ -0,0 +1,12 @@
+type TFunction = (key: string) => string;
+/**
+ * Валидация URL на фронте без дополнительных запросов.
+ * Проверяет: формат, протокол (только http/https), SSRF (localhost, приватные IP).
+ * Если приложение открыто с localhost, URL на localhost разрешены (удобство локальной разработки).
+ *
+ * @param url - строка URL для проверки
+ * @param t - функция перевода для сообщений об ошибках
+ * @throws FileManagerApiError при невалидном URL
+ */
+export declare function validateUrlNoRequest(url: string, t: TFunction): void;
+export {};

package/file-manager/widgets/layout/errorBoundary/errorBoundary.d.ts

@@ -0,0 +1,7 @@
+import React, { ReactNode } from 'react';
+import './errorBoundary.scss';
+interface ErrorBoundaryProps {
+    children: ReactNode;
+}
+export declare const ErrorBoundary: React.ComponentType<ErrorBoundaryProps>;
+export {};

package/iframe/css/sandbox-dark.css

@@ -303,7 +303,7 @@ img[src*='<!--']::after {
 }
 
 em-replace::after {
-  background-color: var(--colorBgBase);
+  background-color: var(--em-colorBgBase);
 }
 
 /* Маркер глобального блока в превью (псевдоэлемент, см. sandbox.css) */