@emailmaker/filemanager 0.10.46 → 0.10.47

package/file-manager.js.LICENSE.txt

@@ -143,6 +143,8 @@ and limitations under the License.
 
 /**![info-circle](data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNTAiIGhlaWdodD0iNTAiIGZpbGw9IiNjYWNhY2EiIHZpZXdCb3g9IjY0IDY0IDg5NiA4OTYiIGZvY3VzYWJsZT0iZmFsc2UiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHBhdGggZD0iTTUxMiA2NEMyNjQuNiA2NCA2NCAyNjQuNiA2NCA1MTJzMjAwLjYgNDQ4IDQ0OCA0NDggNDQ4LTIwMC42IDQ0OC00NDhTNzU5LjQgNjQgNTEyIDY0em0zMiA2NjRjMCA0LjQtMy42IDgtOCA4aC00OGMtNC40IDAtOC0zLjYtOC04VjQ1NmMwLTQuNCAzLjYtOCA4LThoNDhjNC40IDAgOCAzLjYgOCA4djI3MnptLTMyLTM0NGE0OC4wMSA0OC4wMSAwIDAxMC05NiA0OC4wMSA0OC4wMSAwIDAxMCA5NnoiIC8+PC9zdmc+) */
 
+/**![like](data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNTAiIGhlaWdodD0iNTAiIGZpbGw9IiNjYWNhY2EiIHZpZXdCb3g9IjY0IDY0IDg5NiA4OTYiIGZvY3VzYWJsZT0iZmFsc2UiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHBhdGggZD0iTTg4NS45IDUzMy43YzE2LjgtMjIuMiAyNi4xLTQ5LjQgMjYuMS03Ny43IDAtNDQuOS0yNS4xLTg3LjQtNjUuNS0xMTEuMWE2Ny42NyA2Ny42NyAwIDAwLTM0LjMtOS4zSDU3Mi40bDYtMTIyLjljMS40LTI5LjctOS4xLTU3LjktMjkuNS03OS40QTEwNi42MiAxMDYuNjIgMCAwMDQ3MSA5OS45Yy01MiAwLTk4IDM1LTExMS44IDg1LjFsLTg1LjkgMzExSDE0NGMtMTcuNyAwLTMyIDE0LjMtMzIgMzJ2MzY0YzAgMTcuNyAxNC4zIDMyIDMyIDMyaDYwMS4zYzkuMiAwIDE4LjItMS44IDI2LjUtNS40IDQ3LjYtMjAuMyA3OC4zLTY2LjggNzguMy0xMTguNCAwLTEyLjYtMS44LTI1LTUuNC0zNyAxNi44LTIyLjIgMjYuMS00OS40IDI2LjEtNzcuNyAwLTEyLjYtMS44LTI1LTUuNC0zNyAxNi44LTIyLjIgMjYuMS00OS40IDI2LjEtNzcuNy0uMi0xMi42LTItMjUuMS01LjYtMzcuMXpNMTg0IDg1MlY1NjhoODF2Mjg0aC04MXptNjM2LjQtMzUzbC0yMS45IDE5IDEzLjkgMjUuNGE1Ni4yIDU2LjIgMCAwMTYuOSAyNy4zYzAgMTYuNS03LjIgMzIuMi0xOS42IDQzbC0yMS45IDE5IDEzLjkgMjUuNGE1Ni4yIDU2LjIgMCAwMTYuOSAyNy4zYzAgMTYuNS03LjIgMzIuMi0xOS42IDQzbC0yMS45IDE5IDEzLjkgMjUuNGE1Ni4yIDU2LjIgMCAwMTYuOSAyNy4zYzAgMjIuNC0xMy4yIDQyLjYtMzMuNiA1MS44SDMyOVY1NjQuOGw5OS41LTM2MC41YTQ0LjEgNDQuMSAwIDAxNDIuMi0zMi4zYzcuNiAwIDE1LjEgMi4yIDIxLjEgNi43IDkuOSA3LjQgMTUuMiAxOC42IDE0LjYgMzAuNWwtOS42IDE5OC40aDMxNC40QzgyOSA0MTguNSA4NDAgNDM2LjkgODQwIDQ1NmMwIDE2LjUtNy4yIDMyLjEtMTkuNiA0M3oiIC8+PC9zdmc+) */
+
 /**![link](data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNTAiIGhlaWdodD0iNTAiIGZpbGw9IiNjYWNhY2EiIHZpZXdCb3g9IjY0IDY0IDg5NiA4OTYiIGZvY3VzYWJsZT0iZmFsc2UiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHBhdGggZD0iTTU3NCA2NjUuNGE4LjAzIDguMDMgMCAwMC0xMS4zIDBMNDQ2LjUgNzgxLjZjLTUzLjggNTMuOC0xNDQuNiA1OS41LTIwNCAwLTU5LjUtNTkuNS01My44LTE1MC4yIDAtMjA0bDExNi4yLTExNi4yYzMuMS0zLjEgMy4xLTguMiAwLTExLjNsLTM5LjgtMzkuOGE4LjAzIDguMDMgMCAwMC0xMS4zIDBMMTkxLjQgNTI2LjVjLTg0LjYgODQuNi04NC42IDIyMS41IDAgMzA2czIyMS41IDg0LjYgMzA2IDBsMTE2LjItMTE2LjJjMy4xLTMuMSAzLjEtOC4yIDAtMTEuM0w1NzQgNjY1LjR6bTI1OC42LTQ3NGMtODQuNi04NC42LTIyMS41LTg0LjYtMzA2IDBMNDEwLjMgMzA3LjZhOC4wMyA4LjAzIDAgMDAwIDExLjNsMzkuNyAzOS43YzMuMSAzLjEgOC4yIDMuMSAxMS4zIDBsMTE2LjItMTE2LjJjNTMuOC01My44IDE0NC42LTU5LjUgMjA0IDAgNTkuNSA1OS41IDUzLjggMTUwLjIgMCAyMDRMNjY1LjMgNTYyLjZhOC4wMyA4LjAzIDAgMDAwIDExLjNsMzkuOCAzOS44YzMuMSAzLjEgOC4yIDMuMSAxMS4zIDBsMTE2LjItMTE2LjJjODQuNS04NC42IDg0LjUtMjIxLjUgMC0zMDYuMXpNNjEwLjEgMzcyLjNhOC4wMyA4LjAzIDAgMDAtMTEuMyAwTDM3Mi4zIDU5OC43YTguMDMgOC4wMyAwIDAwMCAxMS4zbDM5LjYgMzkuNmMzLjEgMy4xIDguMiAzLjEgMTEuMyAwbDIyNi40LTIyNi40YzMuMS0zLjEgMy4xLTguMiAwLTExLjNsLTM5LjUtMzkuNnoiIC8+PC9zdmc+) */
 
 /**![loading](data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNTAiIGhlaWdodD0iNTAiIGZpbGw9IiNjYWNhY2EiIHZpZXdCb3g9IjAgMCAxMDI0IDEwMjQiIGZvY3VzYWJsZT0iZmFsc2UiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHBhdGggZD0iTTk4OCA1NDhjLTE5LjkgMC0zNi0xNi4xLTM2LTM2IDAtNTkuNC0xMS42LTExNy0zNC42LTE3MS4zYTQ0MC40NSA0NDAuNDUgMCAwMC05NC4zLTEzOS45IDQzNy43MSA0MzcuNzEgMCAwMC0xMzkuOS05NC4zQzYyOSA4My42IDU3MS40IDcyIDUxMiA3MmMtMTkuOSAwLTM2LTE2LjEtMzYtMzZzMTYuMS0zNiAzNi0zNmM2OS4xIDAgMTM2LjIgMTMuNSAxOTkuMyA0MC4zQzc3Mi4zIDY2IDgyNyAxMDMgODc0IDE1MGM0NyA0NyA4My45IDEwMS44IDEwOS43IDE2Mi43IDI2LjcgNjMuMSA0MC4yIDEzMC4yIDQwLjIgMTk5LjMuMSAxOS45LTE2IDM2LTM1LjkgMzZ6IiAvPjwvc3ZnPg==) */

package/hooks/core/files/actions/useFilesCopy.d.ts

@@ -3,6 +3,7 @@ export interface CopyItemsParams {
     items: Array<{
         id: string;
         isFolder?: boolean;
+        newName?: string;
     }>;
     targetFolderId: string;
     getItemNameById: (id?: string | null) => string | undefined;

package/hooks/core/files/useFilesAPI.d.ts

@@ -20,6 +20,7 @@ export interface UseFilesAPIActions {
                 id?: string;
                 name?: string;
                 folderId?: string | null;
+                size?: number;
             }>;
         }) => void;
     }) => Promise<void>;

package/hooks/core/files/useFilesSelection.d.ts

@@ -6,6 +6,7 @@ export interface UseFilesSelectionActions {
         metaKey?: boolean;
         ctrlKey?: boolean;
         shiftKey?: boolean;
+        forceToggle?: boolean;
     }) => void;
 }
 export declare const useFilesSelection: () => {

package/hooks/core/types.d.ts

@@ -78,7 +78,12 @@ export interface FileManagerActions {
     generateMenuItems: () => MenuItem[];
     fetchFiles: (params?: FilesQueryParams) => Promise<void>;
     handleDeleteFile: (fileId: string) => Promise<void>;
-    toggleFileSelection: (fileId: string) => void;
+    toggleFileSelection: (fileId: string, opts?: {
+        metaKey?: boolean;
+        ctrlKey?: boolean;
+        shiftKey?: boolean;
+        forceToggle?: boolean;
+    }) => void;
     handleItemClick: (record: File) => void;
     handleAddFile: () => Promise<void>;
     handleDroppedFiles: (droppedFiles: globalThis.File[]) => Promise<void>;

package/hooks/core/useFiles.d.ts

@@ -29,6 +29,7 @@ export interface UseFilesActions {
                 id?: string;
                 name?: string;
                 folderId?: string | null;
+                size?: number;
             }>;
         }) => void;
     }) => Promise<void>;

package/hooks/useCustomIcons.d.ts

@@ -29,5 +29,6 @@ export declare const useCustomIcons: () => {
     DarkModeIcon: (props?: IconProps) => React.ReactElement<any, string | React.JSXElementConstructor<any>>;
     AiIcon_2: (props?: IconProps) => React.ReactElement<any, string | React.JSXElementConstructor<any>>;
     NoFilesIcon: (props?: IconProps) => React.ReactElement<any, string | React.JSXElementConstructor<any>>;
+    ThumbsUpIcon: (props?: IconProps) => React.ReactElement<any, string | React.JSXElementConstructor<any>>;
     getCustomIcon: (iconName: keyof NonNullable<import("../types").CustomIcons | undefined>, defaultIcon: React.ComponentType<any>, props?: IconProps) => React.ReactElement;
 };

package/hooks/useFileActions.d.ts

@@ -3,7 +3,12 @@ interface UseFileActionsProps {
     files: AppFile[];
     selectedFiles: Set<string>;
     currentMenuFile: string;
-    toggleFileSelection: (fileId: string) => void;
+    toggleFileSelection: (fileId: string, opts?: {
+        metaKey?: boolean;
+        ctrlKey?: boolean;
+        shiftKey?: boolean;
+        forceToggle?: boolean;
+    }) => void;
     showRenameModal: (fileId: string) => void;
     showMoveModal: () => void;
     showCopyModal: () => void;

package/hooks/useFolderSelectionMenu.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { FormInstance } from 'antd/es/form';
+import type { Folder, MenuItem } from '../types';
+interface UseFolderSelectionMenuParams {
+    folders: Folder[];
+    selectedFolder: string | null;
+    EmptyFolderIcon: React.ComponentType<{
+        style?: React.CSSProperties;
+    }>;
+    handleCreateFolderModalOk: (currentForm?: FormInstance) => Promise<Folder | {
+        id?: string;
+    } | undefined>;
+    setIsLoading: (value: boolean) => void;
+    t: (key: string) => string;
+}
+export declare function useFolderSelectionMenu({ folders, selectedFolder, EmptyFolderIcon, handleCreateFolderModalOk, setIsLoading, t, }: UseFolderSelectionMenuParams): {
+    activeFormField: string;
+    setActiveFormField: React.Dispatch<React.SetStateAction<string>>;
+    generateMenuItemsFromFolders: (params: {
+        targetForm: FormInstance;
+        onTreeSelect: (selectedKeys: React.Key[]) => Promise<void>;
+        onComplete: (targetFolder?: string) => void;
+        actionButtonText: string;
+    }) => MenuItem[];
+};
+export {};

package/notification.d.ts

@@ -1,12 +1,11 @@
 interface FileManageErrorInfo {
-  message?: string;            
+  message?: string;
   code?: FileManagerErrorCode;
   status?: number;
-  raw?: any; 
+  raw?: any;
   stack?: string;
 }
 
-
 /**
  * Error codes for FileManager API operations.
  */
@@ -211,7 +210,7 @@ declare namespace Notify {
   /**
    * Details of a single item in batch operation results.
    * Used in the `detailed` array for batch operations (deleteItems, moveItems, copyItems, uploadFiles).
-   * 
+   *
    * @template T - Type of successful operation result data
    */
   export interface BatchOperationDetail<T = unknown> {
@@ -230,7 +229,7 @@ declare namespace Notify {
   /**
    * Result of a batch operation with support for detailed results.
    * Unified type for all batch operations in the file manager.
-   * 
+   *
    * @template T - Type of successful operation result data
    */
   export interface BatchOperationResult<T = unknown> {
@@ -376,7 +375,7 @@ declare namespace Notify {
   /**
    * Base type for error notification events.
    * Includes innerException field for error details.
-   * 
+   *
    * @template TId - Notification event ID type
    * @template TData - Payload data type
    */
@@ -403,7 +402,7 @@ declare namespace Notify {
   /**
    * Base type for success, warning, and info notification events.
    * Does not include innerException field.
-   * 
+   *
    * @template TId - Notification event ID type
    * @template TData - Payload data type
    */
@@ -475,7 +474,6 @@ declare namespace Notify {
    * Extends ItemErrorMap for single item operations and BatchErrorMap for batch operations.
    */
   export interface ErrorMap extends ItemErrorMap, BatchErrorMap {
-
     FILE_DOWNLOAD_FAILED: ImageFilePayload;
     IMAGE_DOWNLOAD_FAILED: ImageFilePayload;
     IMAGE_SAVE_FAILED: ImageFilePayload;
@@ -509,11 +507,17 @@ declare namespace Notify {
     FILES_COPY_DIRECTORY_NOT_SELECTED: never;
 
     FOLDERS_FETCH_FAILED: FolderOperationPayload;
+    FOLDER_ALREADY_EXISTS: FolderOperationPayload;
+    FOLDER_ALREADY_EXISTS_COPY: FolderOperationPayload & { targetFolderId?: string };
+    FOLDER_ALREADY_EXISTS_MOVE: FolderOperationPayload & { targetFolderId?: string };
     FOLDER_CREATE_PROVIDER_NOT_CONFIGURED: FolderOperationPayload;
     FOLDER_CREATE_FAILED: FolderOperationPayload;
     FOLDER_CHILDREN_COUNT_FAILED: FolderOperationPayload;
     FOLDER_CHILDREN_FETCH_FAILED: FolderOperationPayload;
     FILE_URL_VALIDATION_FAILED: FileUrlValidationErrorPayload;
+
+    TRASH_CLEAR_FAILED: OperationErrorPayload;
+    TRASH_CLEAR_ERROR: never;
   }
 
   /**
@@ -544,6 +548,8 @@ declare namespace Notify {
     FOLDER_CREATE_SUCCESS: FolderOperationPayload;
 
     FILE_UPLOAD_ITEM_SUCCESS: FileUploadPayload;
+
+    TRASH_CLEARED_SUCCESS: never;
   }
 
   /**
@@ -564,6 +570,8 @@ declare namespace Notify {
   export interface WarningMap {
     FILES_UPLOAD_UNSUPPORTED_TYPE: UnsupportedFileTypePayload;
     FOLDER_OPERATION_VALIDATION_FAILED: FolderOperationPayload;
+
+    TRASH_CLEARED_PARTIAL: OperationErrorPayload;
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emailmaker/filemanager",
-  "version": "0.10.46",
+  "version": "0.10.47",
   "main": "./file-manager.js",
   "module": "./file-manager.esm.js",
   "types": "./index.d.ts",

package/types.d.ts

@@ -1,9 +1,9 @@
 import React, { ReactNode, RefObject } from 'react';
 import { FormInstance } from 'antd/es/form';
-import { MY_FILES, GIF, STOCK_IMAGES, AI, EDITOR, IMAGE_EXTENSIONS } from './constants';
+import { MY_FILES, GIF, STOCK_IMAGES, ICONS, AI, EDITOR, IMAGE_EXTENSIONS } from './constants';
 import type { InputRef } from 'antd';
-import type { FileManageErrorInfo, Notify, NotifyEvent } from 'notification';
-export * from 'notification';
+import type { FileManageErrorInfo, Notify, NotifyEvent } from './notification';
+export * from './notification';
 export interface Folder {
     id: string;
     name: string;
@@ -112,6 +112,7 @@ export interface CustomIcons {
     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)>;
@@ -137,7 +138,7 @@ export interface FileManagerOptions {
         id: string;
         folderId: string | undefined;
         name: string;
-    }) => void;
+    }) => void | Promise<void>;
     config?: Config;
     customIcons?: CustomIcons;
     dragDropIcon?: string;
@@ -233,6 +234,9 @@ export interface FileManagerDataProviders {
          * в остальных случаях — Blob.
          */
         data: UploadBinary;
+        thumbnail?: string;
+        dimensions?: string;
+        aspectRatio?: string;
         extension?: string;
     }) => Promise<File>;
     uploadFiles?: (request: UploadFilesRequest) => Promise<BatchResult<UploadFileResultData>>;
@@ -240,18 +244,28 @@ export interface FileManagerDataProviders {
         url: string;
         folderId?: string | null;
         noFolder?: boolean;
+        name?: string;
     }) => 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, files: string[]) => Promise<BatchResult<unknown>>;
+    copyItems?: (targetFolderId: string, items: Array<{
+        id: string;
+        newName?: string;
+    }> | string[]) => Promise<BatchResult<unknown>>;
     updateFile?: (fileId: string, updates: {
         name?: string;
         type?: string;
@@ -296,7 +310,12 @@ export interface FileManagerHookReturn {
     handleDeleteFile: (fileId: string) => Promise<void>;
     handleAddFile: () => void;
     handleFolderSelect: (folderId: string) => void;
-    toggleFileSelection: (fileId: 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>;
@@ -361,6 +380,10 @@ export interface Config {
     dataProcessingMode?: 'server' | 'client' | 'auto';
     enableClientSideProcessing?: boolean;
     disablePagination?: boolean;
+    /** При false (или при disablePagination) — пагинации нет, фронт проверяет дубликаты имён и добавляет _1 */
+    hasPagination?: boolean;
+    /** Наличие пагинации. При false — проверка дубликатов имён папок при создании и при copy/move */
+    paginationAvailable?: boolean;
     enableTrashFolder?: boolean;
     staticData?: {
         files?: File[];
@@ -369,6 +392,11 @@ export interface Config {
     customTheme?: CustomTheme;
     UNSPLASH_KEY?: string;
     APP_NAME_UNSPLASH?: string;
+    /** Переопределение URL прокси Streamline (по умолчанию /streamline). Ключ добавляется на прокси. */
+    STREAMLINE_BASE_URL?: string;
+    handleTranslate?: (input: string, opts: {
+        locale?: string;
+    }) => Promise<string>;
     UNSLASH_PROXY_URL?: string;
     pushToGTM?: boolean;
     projectId?: string;
@@ -401,10 +429,53 @@ export interface Config {
     multiSelect?: boolean;
     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;
+    };
     /** Разрешаем произвольные дополнительные поля */
     [key: string]: unknown;
 }
-export type LibraryMenuKey = typeof MY_FILES | typeof GIF | typeof STOCK_IMAGES | typeof AI | typeof EDITOR;
+export type LibraryMenuKey = typeof MY_FILES | typeof GIF | typeof STOCK_IMAGES | typeof ICONS | typeof AI | typeof EDITOR;
+export type StreamlineSearchItem = {
+    hash: string;
+    name: string;
+    imagePreviewUrl: string;
+    isFree: boolean;
+    familySlug: string;
+    familyName: string;
+    categorySlug?: string;
+    categoryName?: string;
+    subcategorySlug?: string;
+    subcategoryName?: string;
+};
+export type StreamlineSearchResponse = {
+    query: string;
+    results: StreamlineSearchItem[];
+    pagination: {
+        total: number;
+        hasMore: boolean;
+        offset: number;
+        nextSkip?: number;
+    };
+};
+export interface IconsTabProps {
+    apiKey?: string;
+    customRequest: (data: string) => void | Promise<void>;
+    query?: string;
+    setQuery?: (query: string) => void;
+    inputRef?: React.RefObject<InputRef>;
+}
 export interface GifItem {
     id: string;
     title: string;

package/utils/errorMessages.d.ts

@@ -1,12 +1,32 @@
 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-ключ.
- * Если кода нет или он не сопоставлен — вернёт undefined.
+ * Поддерживает параметры для шаблонов: allowedChars, fileSize, maxSize.
  */
-export declare const getErrorMessageFromCode: (code: FileManagerErrorCode | undefined, t: TFunction) => string | undefined;
+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;
+/**
+ * Возвращает сообщение для отображения при ошибке загрузки по URL.
+ * Приоритет: код ошибки → понятное сообщение бэкенда → общий fallback.
+ */
+export declare const getUploadByUrlErrorMessage: (apiError: FileManageErrorInfo | undefined, t: TFunction, params?: ErrorMessageParams) => string;
 export {};

package/utils/fileFormatUtils.d.ts

@@ -0,0 +1,39 @@
+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.5;
+    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;

package/utils/fileValidation.d.ts

@@ -32,4 +32,26 @@ export declare const validateFileUrl: (url: string) => Promise<FileValidationRes
 export declare const getFileCategory: (file: File) => string;
 export declare const formatFileSize: (bytes: number) => string;
 export declare const formatFileSizeShort: (bytes?: number) => 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/utils/imageCompression.d.ts

@@ -2,5 +2,6 @@ export interface CompressImageOptions {
     maxSizeMB?: number;
     maxWidthOrHeight?: number;
     mimeType?: string;
+    fileName?: string;
 }
 export declare function compressImageWithLimits(file: File, options?: CompressImageOptions): Promise<File>;

package/utils/jsonDataProvider.d.ts

@@ -37,6 +37,9 @@ export declare class JSONDataProvider implements FileManagerDataProviders {
         type: string;
         folderId?: string | null;
         data: UploadBinary;
+        thumbnail?: string;
+        dimensions?: string;
+        aspectRatio?: string;
         extension?: string;
     }) => Promise<File>;
     uploadFiles: (request: UploadFilesRequest) => Promise<BatchResult<UploadFileResultData>>;
@@ -44,6 +47,7 @@ export declare class JSONDataProvider implements FileManagerDataProviders {
         url: string;
         folderId?: string | null;
         noFolder?: boolean;
+        name?: string;
     }) => Promise<File>;
     updateFile: (fileId: string, updates: {
         name?: string;
@@ -55,6 +59,10 @@ export declare class JSONDataProvider implements FileManagerDataProviders {
         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;

package/utils/mimeUtils.d.ts

@@ -1,3 +1,15 @@
+/**
+ * Нормализует 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)

package/utils/nameNormalization.d.ts

@@ -0,0 +1,23 @@
+import { Config } from '../types';
+/**
+ * Настройки обработки имени по умолчанию
+ */
+export interface NameProcessingOptions {
+    transliterate?: boolean;
+    replaceSpaces?: boolean;
+    removeForbiddenChars?: boolean;
+    toLowerCase?: boolean;
+}
+/**
+ * Транслитерирует кириллицу в латиницу
+ */
+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/utils/svgToPng.d.ts

@@ -0,0 +1,11 @@
+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;
+};
+export declare function rasterizeSvgToPng(svgText: string, outW: number, outH: number, bg?: string): Promise<string>;