@emailmaker/filemanager 0.10.69 → 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/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, type SortOptionType, } 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.69",
+  "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,7 +3,8 @@ 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 */

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,7 +4,7 @@ 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';

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

@@ -67,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;
@@ -216,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?: {
@@ -378,6 +391,11 @@ export interface Config {
     disableMockServer?: boolean;
     activeTab?: string;
     showNotifications?: boolean;
+    /**
+     * TTL (мс) подавления повторных одинаковых уведомлений (type + id + data).
+     * 0 — выключить. По умолчанию 12 с, если не задано.
+     */
+    notificationDedupeTtlMs?: number;
     apiEndpoints?: ApiEndpoints;
     REACT_APP_GIPHY_KEY?: string;
     locale?: string;
@@ -421,7 +439,8 @@ export interface Config {
      */
     dedupeUploadNamesOnClient?: boolean;
     /**
-     * Если нет thumbnail/thumbnailUrl, для превью в таблице/плитке использовать `file.url` (только изображения).
+     * Для превью в таблице/плитке разрешить fallback на `file.url` (только изображения),
+     * если миниатюры нет или она загрузилась с ошибкой.
      */
     previewFallbackToFileUrl?: boolean;
     /**
@@ -540,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;
         };
     };
 }
@@ -556,6 +587,8 @@ export interface ImageGifProps {
 }
 export interface UnsplashImage {
     id: string;
+    width?: number;
+    height?: number;
     description: string;
     urls: {
         raw: string;
@@ -681,6 +714,7 @@ export interface FileManagerProps {
 export interface SafeImageProps {
     thumbnailSrc?: string;
     previewSrc?: string;
+    lightboxSrc?: string;
     alt: string;
     className?: string;
     width?: number;

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>;