@emailmaker/filemanager 0.10.66 → 0.10.68

package/package.json

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

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

@@ -0,0 +1,10 @@
+import type { TFunction } from 'i18next';
+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>;
+    features: Record<string, boolean | undefined>;
+    t: TFunction;
+}
+export declare const fileListAdapter: ListItemAdapter<AppFile, FileListContext, FileListRowModel>;

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

@@ -0,0 +1,20 @@
+import type { File as AppFile } from '../../types';
+import type { ListRowModelBase } from '../list-core/types';
+export interface FileListRowModel extends ListRowModelBase<AppFile> {
+    file: AppFile;
+    isFolder: boolean;
+    nameText: string;
+    folderItemsText: string;
+    dimensionsText: string;
+    sizeText: string;
+    typeText: string;
+    dateText: string;
+    gridInfoText: string;
+    thumbnailSrc?: string;
+    previewSrc?: string;
+    canEdit: boolean;
+    canMove: boolean;
+    canCopy: boolean;
+    canRename: boolean;
+    canDelete: boolean;
+}

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

@@ -0,0 +1,26 @@
+import type { TFunction } from 'i18next';
+import type { File as AppFile } from '../../types';
+import type { RenderWindow, ViewportMetrics } from '../list-core/types';
+import type { FileListRowModel } from './types';
+interface UseFileListEngineParams {
+    files: AppFile[];
+    folderFileCounts: Record<string, number>;
+    features: Record<string, boolean | undefined>;
+    t: TFunction;
+    viewMode: 'table' | 'grid';
+}
+interface UseFileListEngineResult {
+    rowModels: FileListRowModel[];
+    renderRows: FileListRowModel[];
+    renderWindow: RenderWindow<FileListRowModel>;
+    hasAnyValidDate: boolean;
+    handleViewportChange: (metrics: ViewportMetrics) => void;
+}
+/**
+ * File-specific adapter поверх generic list-core.
+ *
+ * Здесь файловый менеджер только передаёт сырые данные и контекст derive-логики,
+ * а само ядро уже отвечает за reuse row-model и подготовку render-window.
+ */
+export declare function useFileListEngine({ files, folderFileCounts, features, t, viewMode, }: UseFileListEngineParams): UseFileListEngineResult;
+export {};

package/presentation/list-core/ListItemAdapter.d.ts

@@ -0,0 +1,9 @@
+import type { ListRowModelBase } from './types';
+export interface ListItemAdapter<TItem, TContext, TRowModel extends ListRowModelBase<TItem>> {
+    getId: (item: TItem) => string;
+    buildSignature: (item: TItem, context: TContext) => string;
+    buildRowModel: (item: TItem, context: TContext, meta: {
+        id: string;
+        signature: string;
+    }) => TRowModel;
+}

package/presentation/list-core/RowModelCache.d.ts

@@ -0,0 +1,13 @@
+import type { ListItemAdapter } from './ListItemAdapter';
+import type { ListRowModelBase } from './types';
+/**
+ * Кэш row-model по `id`.
+ *
+ * Если сигнатура строки не изменилась, возвращаем тот же объект row-model.
+ * Это ключевой механизм для поверхностного rerender таблицы:
+ * `shouldCellUpdate(record !== prevRecord)` начинает реально работать.
+ */
+export declare class RowModelCache<TItem, TContext, TRowModel extends ListRowModelBase<TItem>> {
+    private rowsById;
+    reconcile(items: TItem[], adapter: ListItemAdapter<TItem, TContext, TRowModel>, context: TContext): TRowModel[];
+}

package/presentation/list-core/ViewportController.d.ts

@@ -0,0 +1,10 @@
+import type { ListEngineOptions, ListRowModelBase, RenderWindow } from './types';
+/**
+ * Контроллер render-window.
+ *
+ * Сейчас по умолчанию работает в режиме `full`, но интерфейс сразу готов
+ * под будущий windowed/lazy render без переписывания row-model ядра.
+ */
+export declare class ViewportController<TRowModel extends ListRowModelBase> {
+    createRenderWindow(rows: TRowModel[], options?: ListEngineOptions): RenderWindow<TRowModel>;
+}

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

@@ -0,0 +1,31 @@
+export type RenderStrategy = 'full' | 'windowed';
+export interface ListRowModelBase<TItem = unknown> {
+    id: string;
+    signature: string;
+    item: TItem;
+}
+export interface WindowedRenderConfig {
+    startIndex?: number;
+    endIndex?: number;
+    overscan?: number;
+    estimatedItemSize?: number;
+    itemsPerLane?: number;
+}
+export interface ListEngineOptions {
+    renderStrategy?: RenderStrategy;
+    windowed?: WindowedRenderConfig;
+}
+export interface ViewportMetrics {
+    scrollTop: number;
+    viewportHeight: number;
+    viewportWidth: number;
+    scrollHeight: number;
+}
+export interface RenderWindow<TRowModel> {
+    rows: TRowModel[];
+    startIndex: number;
+    endIndex: number;
+    topOffset: number;
+    bottomOffset: number;
+    totalCount: number;
+}

package/presentation/list-core/useListPresentationEngine.d.ts

@@ -0,0 +1,20 @@
+import type { ListItemAdapter } from './ListItemAdapter';
+import type { ListEngineOptions, ListRowModelBase, RenderWindow } from './types';
+interface UseListPresentationEngineParams<TItem, TContext, TRowModel extends ListRowModelBase<TItem>> {
+    items: TItem[];
+    context: TContext;
+    adapter: ListItemAdapter<TItem, TContext, TRowModel>;
+    options?: ListEngineOptions;
+}
+interface ListPresentationEngineResult<TRowModel> {
+    rowModels: TRowModel[];
+    renderWindow: RenderWindow<TRowModel>;
+}
+/**
+ * Generic headless engine:
+ * - строит стабильные row-model через cache по `id`;
+ * - отдельно считает render-window;
+ * - не знает ничего про файлы, таблицу или плитку.
+ */
+export declare function useListPresentationEngine<TItem, TContext, TRowModel extends ListRowModelBase<TItem>>({ items, context, adapter, options, }: UseListPresentationEngineParams<TItem, TContext, TRowModel>): ListPresentationEngineResult<TRowModel>;
+export {};

package/presentation/list-core/useViewportRenderController.d.ts

@@ -0,0 +1,24 @@
+import type { ListEngineOptions, ViewportMetrics } from './types';
+export interface ViewportRenderPlan {
+    enabled: boolean;
+    estimatedItemSize: number;
+    overscan: number;
+    itemsPerLane: number;
+    fallbackViewportHeight?: number;
+}
+interface UseViewportRenderControllerParams {
+    totalCount: number;
+    plan: ViewportRenderPlan;
+}
+interface ViewportRenderControllerResult {
+    engineOptions: ListEngineOptions;
+    handleViewportChange: (metrics: ViewportMetrics) => void;
+}
+/**
+ * Generic viewport virtualization controller.
+ *
+ * Возвращает готовые `ListEngineOptions` для `ViewportController`, а renderer
+ * снаружи только сообщает текущие scroll metrics контейнера.
+ */
+export declare function useViewportRenderController({ totalCount, plan, }: UseViewportRenderControllerParams): ViewportRenderControllerResult;
+export {};

package/presentation/list-core/viewportMetrics.d.ts

@@ -0,0 +1,3 @@
+import type { ViewportMetrics } from './types';
+export declare function getViewportScrollTargets(element: HTMLElement): Array<HTMLElement | Window>;
+export declare function getViewportMetrics(element: HTMLElement): ViewportMetrics;

package/types.d.ts

@@ -57,6 +57,7 @@ export interface PaginationState {
 }
 export interface FilesQueryParams {
     folderId?: string;
+    noFolder?: boolean;
     search?: string;
     page?: number;
     limit?: number;
@@ -222,6 +223,7 @@ export interface FileManagerDataProviders {
     getChildrenCount?: (folderId?: string) => Promise<number>;
     getFiles: (options: {
         folderId?: string;
+        noFolder?: boolean;
         search?: string;
         sortBy?: SortState['sortBy'];
         sortOrder?: SortState['sortOrder'];
@@ -384,6 +386,12 @@ export interface Config {
         enableUpdateFile?: boolean;
         /** Разрешить выбор директорий в диалоге загрузки (webkitdirectory) */
         enableDirectoryUpload?: boolean;
+        /** Включить вкладку GIF */
+        enableGif?: boolean;
+        /** Включить вкладку stock images */
+        enableStockImages?: boolean;
+        /** Включить вкладку icon stock */
+        enableIconStock?: boolean;
         /** Включить кнопку/пункт редактирования файла */
         enableEdit?: boolean;
         /** Включить перемещение */
@@ -658,4 +666,5 @@ export interface SafeImageProps {
     height?: number;
     preview?: boolean;
     file?: File;
+    getFileData?: (fileId: string, silent?: boolean) => Promise<Blob | undefined>;
 }

package/utils/imageCompression.d.ts

@@ -1,8 +1,10 @@
-export interface CompressImageOptions {
+export interface PrepareImageForUploadOptions {
     maxSizeMB?: number;
     maxWidthOrHeight?: number;
     mimeType?: string;
     fileName?: string;
     libURL?: string;
+    enableCompression?: boolean;
 }
-export declare function compressImageWithLimits(file: File, options?: CompressImageOptions): Promise<File>;
+export declare function prepareImageForUpload(file: File, options?: PrepareImageForUploadOptions): Promise<File>;
+export declare const compressImageWithLimits: typeof prepareImageForUpload;

package/utils/jsonDataProvider.d.ts

@@ -19,6 +19,7 @@ export declare class JSONDataProvider implements FileManagerDataProviders {
     }) => Promise<Folder[]>;
     getFiles: (options?: {
         folderId?: string;
+        noFolder?: boolean;
         search?: string;
         sortBy?: "name" | "size" | "date" | "type";
         sortOrder?: "asc" | "desc";