@emailmaker/filemanager 0.10.68 → 0.10.70

package/file-manager.js.LICENSE.txt

@@ -4,21 +4,6 @@
 	http://jedwatson.github.io/classnames
 */
 
-/*! *****************************************************************************
-Copyright (c) Microsoft Corporation. All rights reserved.
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use
-this file except in compliance with the License. You may obtain a copy of the
-License at http://www.apache.org/licenses/LICENSE-2.0
-
-THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
-WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
-MERCHANTABLITY OR NON-INFRINGEMENT.
-
-See the Apache Version 2.0 License for specific language governing permissions
-and limitations under the License.
-***************************************************************************** */
-
 /*! Fabric.js Copyright 2008-2015, Printio (Juriy Zaytsev, Maxim Chernyak) */
 
 /**

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/hooks/index.d.ts

@@ -3,3 +3,5 @@ export { useFileActions } from './useFileActions';
 export { usePixieEditor } from './usePixieEditor';
 export { useSidebarResize } from './useSidebarResize';
 export { useLastDirectory } from './useLastDirectory';
+export { useControlledImageLoader } from './useControlledImageLoader';
+export { useViewportMetricsSync } from './useViewportMetricsSync';

package/hooks/notifications/notificationDedupe.d.ts

@@ -0,0 +1,6 @@
+import type { NotifyEvent } from '../../types';
+export declare function getNotificationDedupeKey(event: NotifyEvent): string;
+/** Если то же событие уже показывали недавно — глушим видимость (silent). */
+export declare function suppressIfDuplicateWithinTtl(event: NotifyEvent, ttlMs: number): void;
+/** Вызывать только после фактического показа уведомления пользователю. */
+export declare function recordNotificationShown(event: NotifyEvent, ttlMs: number): void;

package/hooks/useControlledImageLoader.d.ts

@@ -0,0 +1,18 @@
+export type ControlledImageStatus = 'idle' | 'queued' | 'loading' | 'loaded' | 'error';
+export interface ControlledImageSnapshot {
+    status: ControlledImageStatus;
+    shouldLoad: boolean;
+}
+export interface ControlledImageLoader {
+    getSnapshot: (id: string, src: string) => ControlledImageSnapshot;
+    subscribe: (id: string, src: string, listener: (snapshot: ControlledImageSnapshot) => void) => (() => void);
+    setActive: (id: string, src: string, active: boolean) => void;
+    markLoaded: (id: string) => void;
+    markError: (id: string) => void;
+    release: (id: string) => void;
+}
+interface UseControlledImageLoaderOptions {
+    maxConcurrent?: number;
+}
+export declare function useControlledImageLoader({ maxConcurrent, }?: UseControlledImageLoaderOptions): ControlledImageLoader;
+export {};

package/hooks/useViewportMetricsSync.d.ts

@@ -0,0 +1,2 @@
+import { getViewportMetrics } from '../presentation/list-core/viewportMetrics';
+export declare function useViewportMetricsSync<TElement extends HTMLElement>(onViewportChange: (metrics: ReturnType<typeof getViewportMetrics>) => void, deps: readonly unknown[]): import("react").MutableRefObject<TElement | null>;

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, type FileManagerItemMeta, } 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/notification.d.ts

@@ -143,6 +143,8 @@ interface FilesQueryParams {
   sortBy?: 'name' | 'size' | 'date' | 'type';
   sortOrder?: 'asc' | 'desc';
   itemType?: 'file' | 'folder' | 'all';
+  /** Человекочитаемое имя папки для UI (не отправляется на API). */
+  folderName?: string;
 }
 
 /**
@@ -352,6 +354,8 @@ declare namespace Notify {
    */
   export interface FetchFilesErrorPayload {
     params?: FilesQueryParams;
+    /** Отображаемое имя папки списка (после resolve getItem / path / кэша). */
+    folderName?: string | null;
   }
 
   /**
@@ -409,6 +413,11 @@ declare namespace Notify {
      * Level of the operation: 'item' for single item operations, 'batch' for batch operations.
      */
     level?: 'item' | 'batch';
+    /**
+     * Если true — применять TTL-дедупликацию одинаковых уведомлений (после interceptors).
+     * Для upload/мутаций обычно не задаётся или false.
+     */
+    notificationDedupe?: boolean;
   };
 
   /**

package/package.json

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

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

@@ -3,8 +3,11 @@ import type { File as AppFile } from '../../types';
 import type { ListItemAdapter } from '../list-core/ListItemAdapter';
 import type { FileListRowModel } from './types';
 export interface FileListContext {
-    folderFileCounts: Record<string, number>;
+    /** null — ошибка загрузки счётчика, показываем прочерк */
+    folderFileCounts: Record<string, number | null>;
     features: Record<string, boolean | undefined>;
     t: TFunction;
+    /** См. Config.previewFallbackToFileUrl */
+    previewFallbackToFileUrl?: boolean;
 }
 export declare const fileListAdapter: ListItemAdapter<AppFile, FileListContext, FileListRowModel>;

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

@@ -12,6 +12,7 @@ export interface FileListRowModel extends ListRowModelBase<AppFile> {
     gridInfoText: string;
     thumbnailSrc?: string;
     previewSrc?: string;
+    lightboxSrc?: string;
     canEdit: boolean;
     canMove: boolean;
     canCopy: boolean;

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

@@ -4,10 +4,11 @@ import type { RenderWindow, ViewportMetrics } from '../list-core/types';
 import type { FileListRowModel } from './types';
 interface UseFileListEngineParams {
     files: AppFile[];
-    folderFileCounts: Record<string, number>;
+    folderFileCounts: Record<string, number | null>;
     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/presentation/list-core/types.d.ts

@@ -1,4 +1,4 @@
-export type RenderStrategy = 'full' | 'windowed';
+export type RenderStrategy = 'full' | 'windowed' | 'positioned';
 export interface ListRowModelBase<TItem = unknown> {
     id: string;
     signature: string;
@@ -11,9 +11,25 @@ export interface WindowedRenderConfig {
     estimatedItemSize?: number;
     itemsPerLane?: number;
 }
+export interface PositionedLayoutItem {
+    index: number;
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+    bottom: number;
+}
+export interface PositionedRenderConfig {
+    layout: PositionedLayoutItem[];
+    viewportTop: number;
+    viewportBottom: number;
+    overscanPx?: number;
+    containerHeight: number;
+}
 export interface ListEngineOptions {
     renderStrategy?: RenderStrategy;
     windowed?: WindowedRenderConfig;
+    positioned?: PositionedRenderConfig;
 }
 export interface ViewportMetrics {
     scrollTop: number;
@@ -28,4 +44,9 @@ export interface RenderWindow<TRowModel> {
     topOffset: number;
     bottomOffset: number;
     totalCount: number;
+    containerHeight?: number;
+    positionedItems?: Array<{
+        row: TRowModel;
+        layout: PositionedLayoutItem;
+    }>;
 }

package/presentation/media-list/MediaListAdapter.d.ts

@@ -0,0 +1,9 @@
+import type { ListItemAdapter } from '../list-core/ListItemAdapter';
+import type { MediaListRowModel } from './types';
+export interface MediaListContext<TItem> {
+    getPreviewSrc: (item: TItem) => string | undefined;
+    getAltText: (item: TItem) => string;
+    getWidth?: (item: TItem) => number | undefined;
+    getHeight?: (item: TItem) => number | undefined;
+}
+export declare function createMediaListAdapter<TItem>(getId: (item: TItem) => string): ListItemAdapter<TItem, MediaListContext<TItem>, MediaListRowModel<TItem>>;

package/presentation/media-list/types.d.ts

@@ -0,0 +1,8 @@
+import type { ListRowModelBase } from '../list-core/types';
+export interface MediaListRowModel<TItem> extends ListRowModelBase<TItem> {
+    previewSrc?: string;
+    altText: string;
+    width?: number;
+    height?: number;
+    aspectRatio: number;
+}

package/presentation/media-list/useMediaListEngine.d.ts

@@ -0,0 +1,34 @@
+import type { PositionedLayoutItem, ViewportMetrics, RenderWindow } from '../list-core/types';
+import type { MediaListRowModel } from './types';
+type MediaLayoutMode = 'masonry' | 'grid';
+interface UseMediaListEngineParams<TItem> {
+    items: TItem[];
+    getId: (item: TItem) => string;
+    getPreviewSrc: (item: TItem) => string | undefined;
+    getAltText: (item: TItem) => string;
+    getWidth?: (item: TItem) => number | undefined;
+    getHeight?: (item: TItem) => number | undefined;
+    layoutMode?: MediaLayoutMode;
+    minColumnWidth?: number;
+    estimatedItemHeight?: number;
+    gap?: number;
+    overscanPx?: number;
+    prefetchThresholdPx?: number;
+    resolveColumnCount?: (viewportWidth: number) => number;
+    virtualizationThreshold?: number;
+}
+interface UseMediaListEngineResult<TItem> {
+    rowModels: MediaListRowModel<TItem>[];
+    renderRows: MediaListRowModel<TItem>[];
+    renderWindow: RenderWindow<MediaListRowModel<TItem>>;
+    positionedItems: Array<{
+        row: MediaListRowModel<TItem>;
+        layout: PositionedLayoutItem;
+    }>;
+    containerHeight: number;
+    isNearEnd: boolean;
+    viewportMetrics: ViewportMetrics;
+    handleViewportChange: (metrics: ViewportMetrics) => void;
+}
+export declare function useMediaListEngine<TItem>({ items, getId, getPreviewSrc, getAltText, getWidth, getHeight, layoutMode, minColumnWidth, estimatedItemHeight, gap, overscanPx, prefetchThresholdPx, resolveColumnCount, virtualizationThreshold, }: UseMediaListEngineParams<TItem>): UseMediaListEngineResult<TItem>;
+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;
@@ -64,6 +67,8 @@ export interface FilesQueryParams {
     sortBy?: 'name' | 'size' | 'date' | 'type';
     sortOrder?: 'asc' | 'desc';
     itemType?: 'file' | 'folder' | 'all';
+    /** Имя папки для уведомлений; не уходит в dataProviders.getFiles при явной передаче полей. */
+    folderName?: string;
 }
 export interface ApiPaginationResponse {
     page: number;
@@ -152,7 +157,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;
@@ -213,7 +218,18 @@ export interface UploadFilesRequest {
     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;
     getFileData: (fileId: string) => Promise<Blob>;
     findFileByUrl?: (url: string) => Promise<File | null>;
     getFolders?: (options?: {
@@ -368,11 +384,18 @@ 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;
     activeTab?: string;
     showNotifications?: boolean;
+    /**
+     * TTL (мс) подавления повторных одинаковых уведомлений (type + id + data).
+     * 0 — выключить. По умолчанию 12 с, если не задано.
+     */
+    notificationDedupeTtlMs?: number;
     apiEndpoints?: ApiEndpoints;
     REACT_APP_GIPHY_KEY?: string;
     locale?: string;
@@ -406,10 +429,25 @@ 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;
+    /**
+     * Для превью в таблице/плитке разрешить fallback на `file.url` (только изображения),
+     * если миниатюры нет или она загрузилась с ошибкой.
+     */
+    previewFallbackToFileUrl?: boolean;
+    /**
+     * Сохранять копию из Pixie в текущую папку исходного файла.
+     * По умолчанию copy-save идёт через `noFolder` во временную папку на стороне хоста.
+     */
+    saveCopyToCurrentFolder?: boolean;
     enableTrashFolder?: boolean;
     staticData?: {
         files?: File[];
@@ -462,6 +500,8 @@ export interface Config {
     /** Alias для compessorUrl с корректным написанием. */
     compressorUrl?: string;
     multiSelect?: boolean;
+    /** Белый список сортировок для отображения в дропдауне. Если не указан — доступны все. */
+    sortOptions?: SortOptionType[];
     defaultFolderName?: string;
     availableImageExtensions?: Array<(typeof IMAGE_EXTENSIONS)[number]>;
     /** Настройки обработки имен файлов при загрузке */
@@ -519,6 +559,18 @@ export interface GifItem {
     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;
         };
     };
 }
@@ -535,6 +587,8 @@ export interface ImageGifProps {
 }
 export interface UnsplashImage {
     id: string;
+    width?: number;
+    height?: number;
     description: string;
     urls: {
         raw: string;
@@ -635,7 +689,7 @@ export interface FileManagerProps {
         id: string;
         folderId: string | undefined;
         name: string;
-    }) => void;
+    }, meta?: EditorSaveMeta) => void;
     searchQuery?: string;
     sortBySize?: string;
     dataProviders?: FileManagerDataProviders;
@@ -660,6 +714,7 @@ export interface FileManagerProps {
 export interface SafeImageProps {
     thumbnailSrc?: string;
     previewSrc?: string;
+    lightboxSrc?: string;
     alt: string;
     className?: string;
     width?: number;

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/jsonDataProvider.d.ts

@@ -1,4 +1,4 @@
-import { FileManagerDataProviders, File, Folder, Config, UploadFilesRequest, UploadFileResultData, BatchResult, UploadBinary } from '../types';
+import { FileManagerDataProviders, File, FileManagerItemMeta, Folder, Config, UploadFilesRequest, UploadFileResultData, BatchResult, UploadBinary } from '../types';
 export declare class JSONDataProvider implements FileManagerDataProviders {
     private files;
     private folders;
@@ -12,6 +12,7 @@ export declare class JSONDataProvider implements FileManagerDataProviders {
     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;

package/utils/nameNormalization.d.ts

@@ -9,7 +9,8 @@ export interface NameProcessingOptions {
     toLowerCase?: boolean;
 }
 /**
- * Транслитерирует кириллицу в латиницу
+ * Транслитерирует кириллицу в латиницу.
+ * NFC: «й» в NFD — это и + combining breve; без нормализации получится «ĭ» вместо «y».
  */
 export declare function transliterateRuToEn(text: string): string;
 /**

package/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/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 - функция перевода для сообщений об ошибках