@emailmaker/filemanager 0.10.68 → 0.10.69

package/hooks/core/types.d.ts

@@ -1,8 +1,13 @@
 import { FormInstance } from 'antd/es/form';
-import { File, Folder, FileManagerDataProviders, PaginationState, PathItem, MenuItem, FilesQueryParams, LibraryMenuKey } from '../../types';
+import { File, Folder, FileManagerDataProviders, PaginationState, PathItem, MenuItem, FilesQueryParams, LibraryMenuKey, SortOptionType } from '../../types';
 export type SortByType = 'name' | 'size' | 'date' | 'type';
 export type SortOrderType = 'asc' | 'desc';
-export type SortOptionType = 'date-desc' | 'date-asc' | 'size-desc' | 'size-asc' | 'name-asc' | 'name-desc' | 'type-asc';
+export type { SortOptionType };
+/** Полный список опций сортировки в дропдауне (порядок отображения). */
+export declare const ALL_SORT_OPTIONS: {
+    value: SortOptionType;
+    labelKey: string;
+}[];
 export declare const parseSortOption: (option: SortOptionType) => {
     sortBy: SortByType;
     sortOrder: SortOrderType;

package/index.d.ts

@@ -17,7 +17,7 @@ export { FileContent } from './components/FileContent/FileContent';
 export { FileModals } from './components/FileModals/FileModals';
 export { FolderSidebar } from './components/FolderSidebar/FolderSidebar';
 export { installResizeObserverErrorHandler, uninstallResizeObserverErrorHandler } from './utils/resizeObserverHandler';
-export { type Folder, type File, type PathItem, type MenuItem, type FileManagerOptions, type FileManagerHookReturn, type FileManagerErrorCode, type IFileManagerApiError, } from './types';
+export { type Folder, type File, type PathItem, type MenuItem, type FileManagerOptions, type FileManagerHookReturn, type FileManagerErrorCode, type IFileManagerApiError, type SortOptionType, } from './types';
 export { FileManagerApiError } from './shared/fileManagerApiError';
 export { mapHttpStatusToErrorCode } from './shared/mapHttpStatusToErrorCode';
 export { type InitPixieEditorOptions, type Options as FileManagerInitOptions, type UniversalInitOptions, } from './file-manager';

package/package.json

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

package/presentation/file-list/FileListAdapter.d.ts

@@ -6,5 +6,7 @@ export interface FileListContext {
     folderFileCounts: Record<string, number>;
     features: Record<string, boolean | undefined>;
     t: TFunction;
+    /** См. Config.previewFallbackToFileUrl */
+    previewFallbackToFileUrl?: boolean;
 }
 export declare const fileListAdapter: ListItemAdapter<AppFile, FileListContext, FileListRowModel>;

package/presentation/file-list/useFileListEngine.d.ts

@@ -8,6 +8,7 @@ interface UseFileListEngineParams {
     features: Record<string, boolean | undefined>;
     t: TFunction;
     viewMode: 'table' | 'grid';
+    previewFallbackToFileUrl?: boolean;
 }
 interface UseFileListEngineResult {
     rowModels: FileListRowModel[];
@@ -22,5 +23,5 @@ interface UseFileListEngineResult {
  * Здесь файловый менеджер только передаёт сырые данные и контекст derive-логики,
  * а само ядро уже отвечает за reuse row-model и подготовку render-window.
  */
-export declare function useFileListEngine({ files, folderFileCounts, features, t, viewMode, }: UseFileListEngineParams): UseFileListEngineResult;
+export declare function useFileListEngine({ files, folderFileCounts, features, t, viewMode, previewFallbackToFileUrl, }: UseFileListEngineParams): UseFileListEngineResult;
 export {};

package/types.d.ts

@@ -44,8 +44,11 @@ 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;
@@ -152,7 +155,7 @@ export interface FileManagerOptions {
         id: string;
         folderId: string | undefined;
         name: string;
-    }) => void | Promise<void>;
+    }, meta?: EditorSaveMeta) => void | Promise<void>;
     config?: Config;
     customIcons?: CustomIcons;
     dragDropIcon?: string;
@@ -368,6 +371,8 @@ interface Limits {
 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 interface Config {
     theme?: 'light' | 'dark' | 'system';
     disableMockServer?: boolean;
@@ -406,10 +411,24 @@ export interface Config {
     dataProcessingMode?: 'server' | 'client' | 'auto';
     enableClientSideProcessing?: boolean;
     disablePagination?: boolean;
-    /** При false (или при disablePagination) — пагинации нет, фронт проверяет дубликаты имён и добавляет _1 */
+    /** При false (или при disablePagination) — пагинации нет в UI и в запросах списка (без page/limit). */
     hasPagination?: boolean;
-    /** Наличие пагинации. При false — проверка дубликатов имён папок при создании и при copy/move */
+    /** Наличие пагинации на бэкенде (отображение постраничности и т.п.). */
     paginationAvailable?: boolean;
+    /**
+     * Клиент устраняет дубликаты имён при загрузке, копии из Pixie, URL, batch, copy/move, создании папки.
+     * Отдельно от настроек пагинации (`disablePagination`, `hasPagination`, `paginationAvailable`).
+     */
+    dedupeUploadNamesOnClient?: boolean;
+    /**
+     * Если нет thumbnail/thumbnailUrl, для превью в таблице/плитке использовать `file.url` (только изображения).
+     */
+    previewFallbackToFileUrl?: boolean;
+    /**
+     * Сохранять копию из Pixie в текущую папку исходного файла.
+     * По умолчанию copy-save идёт через `noFolder` во временную папку на стороне хоста.
+     */
+    saveCopyToCurrentFolder?: boolean;
     enableTrashFolder?: boolean;
     staticData?: {
         files?: File[];
@@ -462,6 +481,8 @@ export interface Config {
     /** Alias для compessorUrl с корректным написанием. */
     compressorUrl?: string;
     multiSelect?: boolean;
+    /** Белый список сортировок для отображения в дропдауне. Если не указан — доступны все. */
+    sortOptions?: SortOptionType[];
     defaultFolderName?: string;
     availableImageExtensions?: Array<(typeof IMAGE_EXTENSIONS)[number]>;
     /** Настройки обработки имен файлов при загрузке */
@@ -635,7 +656,7 @@ export interface FileManagerProps {
         id: string;
         folderId: string | undefined;
         name: string;
-    }) => void;
+    }, meta?: EditorSaveMeta) => void;
     searchQuery?: string;
     sortBySize?: string;
     dataProviders?: FileManagerDataProviders;

package/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/utils/resolveUniqueUploadName.d.ts

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

package/utils/urlNormalization.d.ts

@@ -3,3 +3,8 @@
  * Убирает 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/utils/urlValidation.d.ts

@@ -2,6 +2,7 @@ type TFunction = (key: string) => string;
 /**
  * Валидация URL на фронте без дополнительных запросов.
  * Проверяет: формат, протокол (только http/https), SSRF (localhost, приватные IP).
+ * Если приложение открыто с localhost, URL на localhost разрешены (удобство локальной разработки).
  *
  * @param url - строка URL для проверки
  * @param t - функция перевода для сообщений об ошибках