@emailmaker/emailmaker 1.1.69 → 1.1.71

package/webpack/pluginDev/index.d.ts

@@ -5,21 +5,21 @@ type PluginDevOptions = {
   externals?: PluginDevExternalsMode | 'global';
   alias?: boolean;
   /**
-   * Точные bare-specifier'ы deep-импортов runtime пакетов, которым **разрешён** обход
-   * singleton-инварианта (например, `'antd/es/locale/zh_CN'`).
+   * Exact bare specifiers of runtime package deep imports that are **allowed** to bypass
+   * the singleton invariant (for example, `'antd/es/locale/zh_CN'`).
    *
-   * По умолчанию все deep-импорты runtime пакетов (`antd/es/...`, `react-dom/server`, …),
-   * не объявленные в `runtime-contract.ts`, **бросают ошибку на сборке** плагина, чтобы
-   * не расщепить singleton-граф между хостом и плагином (host + plugin = две копии).
+   * By default every deep import of a runtime package (`antd/es/...`, `react-dom/server`, …)
+   * that is not declared in `runtime-contract.ts` **fails the plugin build**, so that the
+   * singleton graph is not split between host and plugin (host + plugin = two copies).
    *
-   * Этот аллоулист — escape-hatch для редких сценариев, когда автор плагина:
-   *   - сознательно тянет deep-subpath из локального `node_modules/<pkg>/...`,
-   *   - готов получить **второй инстанс** пакета внутри своего бандла,
-   *   - и подтверждает это явно в plugin-конфиге (review-friendly).
+   * This allowlist is an escape hatch for the rare case where the plugin author:
+   *   - deliberately pulls a deep subpath from a local `node_modules/<pkg>/...`,
+   *   - accepts a **second instance** of the package inside their bundle,
+   *   - and states it explicitly in the plugin config (review-friendly).
    *
-   * При срабатывании выводится `console.warn(...)`, плагин не падает.
-   * Сравнение строгое (exact match), wildcard-ы / RegExp не поддерживаются —
-   * каждый deep-путь должен быть перечислен явно.
+   * A match only prints `console.warn(...)`; the plugin keeps building.
+   * Comparison is strict (exact match) — wildcards and RegExp are not supported,
+   * every deep path has to be listed explicitly.
    *
    * @example
    * ```ts

package/file-manager/.build-meta.json

@@ -1,5 +0,0 @@
-{
-  "version": 1,
-  "hash": "3f662b4b8ddc2c2b20d9d4f6b524c3a9f2316bc1042fa8fb2489707e2fec1af9",
-  "prefix": "em"
-}

package/file-manager/adapters/DataSourceProxyBase.clearCache.test.d.ts

@@ -1 +0,0 @@
-export {};

package/file-manager/adapters/DataSourceProxyBase.d.ts

@@ -1,229 +0,0 @@
-import type { ApiPaginationResponse, BatchResult, File, FileManagerDataProviders, Folder, SortState, UploadFileResultData, UploadFilesRequest } from '../types';
-import type { FileSystemItem, GetFileDataOptions, StorageProvider, StorageProviderController } from '../types/storage';
-import { ViewStrategyOptions } from './TreeCache';
-/**
- * DI config for {@link DataSourceProxyBase}.
- * All fields are optional — the class works standalone with EN-only defaults.
- */
-export interface DataSourceProxyConfig {
-    /**
-     * Custom fetch implementation (e.g. with CDN proxy, auth headers, retries).
-     * Used when loading file binary data via URL.
-     * Falls back to global `fetch` when omitted.
-     */
-    fetchWithProxy?: (url: string, init?: RequestInit) => Promise<Response>;
-}
-/**
- * Subset of FileManager options used by {@link DataSourceProxyBase}.
- */
-export interface FileManagerProxyOptions {
-    enableTrash?: boolean;
-    enablePagination?: boolean;
-    unifiedCatalogFetch?: boolean;
-    clientSideFilter?: boolean | ((items: FileSystemItem[], search?: string) => FileSystemItem[]);
-    clientSideSorting?: boolean | ((items: FileSystemItem[], sortBy?: SortState['sortBy'], sortOrder?: SortState['sortOrder']) => FileSystemItem[]);
-    clientSidePaging?: boolean | ((items: FileSystemItem[], page?: number, limit?: number) => FileSystemItem[]);
-    cacheStrategy?: ViewStrategyOptions & {
-        ttl?: number;
-        errorTtl?: number;
-    };
-}
-export interface DataSourceProxyOptions {
-    rootId?: string;
-    trashPath?: string;
-    tempPath?: string;
-    useSoftDelete?: boolean;
-    batchOperationFallback?: boolean;
-    validateDuplicates?: boolean;
-}
-/**
- * Caching adapter: wraps a {@link StorageProvider} and exposes a {@link FileManagerDataProviders} interface.
- * Handles client-side caching (TreeCache), soft-delete, pagination, and deduplication.
- * Extend this class in a consumer app to add backend-specific logic.
- */
-export declare class DataSourceProxyBase implements FileManagerDataProviders {
-    private readonly _dataProvider;
-    private readonly _options;
-    private readonly _pathOptions;
-    private readonly _cache;
-    private readonly _rootId;
-    private readonly _useSoftDelete;
-    private readonly _enableTrash;
-    private readonly _validateDuplicates;
-    /** Next `getFileData` for this normalized file id uses HTTP no-store (e.g. after overwrite). */
-    private readonly _blobFetchForceReloadOnceIds;
-    /** Frontend-only guard against reads racing with delete operations. */
-    private readonly _mutationRegistry;
-    private _getTrashPath;
-    private _getPathLookupCandidates;
-    private _folderFromResolvedPath;
-    private _resolveFolderByPath;
-    private _findOrCreateFolderByPath;
-    private getTrashFolder;
-    private getTempFolder;
-    private readonly _config;
-    constructor(_dataProvider: StorageProvider, _options: FileManagerProxyOptions | undefined, _pathOptions: DataSourceProxyOptions, config?: DataSourceProxyConfig);
-    setController(controller: StorageProviderController): void;
-    clearCache(pathFolder?: string | null): Promise<void>;
-    /**
-     * After save/overwrite, the next `getFileData` for this file id will use `forceReload` (HTTP no-store).
-     */
-    markNextFileBlobFetchBypassHttpCache(fileId: string): void;
-    /**
-     * Нормализует идентификатор с использованием текущих rootId
-     */
-    normalizeId(id: string | null | undefined): string;
-    private _isDeletingId;
-    private _collectDeletingIds;
-    private _emptyFilesResult;
-    /**
-     * Проверяет валидность имени файла/папки
-     */
-    private _validateName;
-    /**
-     * Проверяет, что целевая папка в кэше является папкой (если она есть в кэше)
-     * Не проверяет существование, так как отсутствие в кэше не означает отсутствие на бэкенде
-     */
-    private _validateTargetFolderType;
-    /**
-     * Проверяет, существует ли элемент с указанным именем в целевой папке (только через кэш, без обращения к бэку)
-     */
-    private _checkNameExistsInCache;
-    private _getUrl;
-    private _getThumbnailUrl;
-    private _mapItem;
-    /**
-     * Проверяет, является ли targetFolderId дочерней папкой sourceFolderId (циклическая ссылка)
-     */
-    private _isAncestor;
-    getFile(folderId: string, name: string): Promise<FileSystemItem | null>;
-    /**
-     * File metadata by id: entity cache first; on miss, loads parent listing via {@link getFile} / {@link getFiles} (i.e. provider `getItems`).
-     * Only practical when ids are path-shaped and {@link StorageProvider.pathMode} is true; otherwise cache-only.
-     */
-    getFileById(fileId: string): Promise<File | null>;
-    private _getFileByPathStyleId;
-    getFileUrl(folderId: string | null | undefined, name: string): Promise<string | undefined>;
-    /**
-     * Получает список файлов и папок с поддержкой пагинации, фильтрации и сортировки
-     */
-    getFiles({ folderId, search, sortBy, sortOrder, page, limit, itemType, noFolder, }: {
-        folderId?: string | null;
-        search?: string;
-        sortBy?: SortState['sortBy'];
-        sortOrder?: SortState['sortOrder'];
-        page?: number;
-        limit?: number;
-        itemType: 'file' | 'folder' | 'all';
-        noFolder?: boolean;
-    }): Promise<{
-        files: File[];
-        pagination: Partial<ApiPaginationResponse>;
-    }>;
-    /**
-     * Стандартная клиентская сортировка файлов
-     */
-    private _defaultClientSideSort;
-    /**
-     * Получает данные файла в виде Blob
-     */
-    getFileData(fileId: string, options?: GetFileDataOptions): Promise<Blob>;
-    getFileData(file: File, options?: GetFileDataOptions): Promise<Blob>;
-    findFileByUrl(url: string): Promise<File | null>;
-    /**
-     * Получает количество элементов в папке
-     */
-    getChildrenCount(folderId?: string): Promise<number>;
-    private _isPathFolderNotFoundError;
-    /**
-     * Загружает файл на сервер
-     */
-    _uploadFile(file: {
-        name: string;
-        size: number;
-        type: string;
-        folderId?: string | null;
-        data: Blob | globalThis.File;
-    }): Promise<File>;
-    uploadFiles(request: UploadFilesRequest): Promise<BatchResult<UploadFileResultData>>;
-    /**
-     * Удаляет файл (либо полностью, либо перемещает в корзину в зависимости от настроек)
-     */
-    deleteFile(fileId: string): Promise<boolean>;
-    /**
-     * Удаляет файл (либо полностью, либо перемещает в корзину в зависимости от настроек)
-     */
-    deleteItems(itemIds: string[], options: {
-        permanent: boolean;
-    }): Promise<BatchResult<{}>>;
-    /**
-     * Полностью удаляет файлы
-     */
-    private hardDeleteItems;
-    /**
-     * Полностью удаляет файл без возможности восстановления
-     */
-    private hardDeleteItem;
-    /**
-     * Очищает корзину (удаляет все файлы из корзины)
-     */
-    cleanTrash(): Promise<{
-        success: boolean;
-        deletedCount?: number;
-    }>;
-    /**
-     * Создает новую папку
-     */
-    createFolder({ name, parentId, is_force_create, }: {
-        name: string;
-        parentId?: string | null;
-        is_force_create?: boolean;
-    }): Promise<Folder>;
-    /**
-     * Удаляет папку (либо полностью, либо перемещает в корзину в зависимости от настроек)
-     */
-    deleteFolder(folderId: string): Promise<boolean>;
-    /**
-     * Переименовывает папку
-     */
-    renameFolder(folderId: string, newName: string): Promise<Folder>;
-    /**
-     * Переименовывает файл
-     */
-    renameFile(fileId: string, newName: string): Promise<File>;
-    /**
-     * Перемещает элемент (файл или папку)
-     */
-    moveItem({ itemId, targetFolderId, isFolder, }: {
-        itemId: string;
-        targetFolderId: string | null;
-        isFolder: boolean;
-    }): Promise<boolean>;
-    moveItems(targetFolderId: string, itemIds: string[]): Promise<BatchResult<{}>>;
-    /**
-     * Копирует элемент (файл или папку)
-     */
-    copyItem({ itemId, targetFolderId, }: {
-        itemId: string;
-        targetFolderId: string | null;
-        isFolder: boolean;
-    }): Promise<boolean>;
-    copyItems(targetFolderId: string, items: Array<{
-        id: string;
-        newName?: string;
-    }> | string[]): Promise<BatchResult<{}>>;
-    /**
-     * Загружает файл по URL
-     */
-    uploadFileByUrl(data: {
-        url: string;
-        folderId?: string | null;
-        noFolder?: boolean;
-        name?: string;
-        eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif';
-    }): Promise<File>;
-    /**
-     * Обновляет данные файла
-     */
-    updateFile(fileId: string, updates: Partial<Omit<File, 'id'>>): Promise<File>;
-}

package/file-manager/adapters/DataSourceProxyBase.rename.test.d.ts

@@ -1 +0,0 @@
-export {};

package/file-manager/adapters/DataSourceProxyBase.trash.test.d.ts

@@ -1 +0,0 @@
-export {};

package/file-manager/adapters/DataSourceProxyBase.upload.test.d.ts

@@ -1 +0,0 @@
-export {};

package/file-manager/adapters/FailedRequestCache.d.ts

@@ -1,20 +0,0 @@
-/**
- * Single store for short-lived cached request failures (negative cache).
- * Used by {@link TreeCache} for children views and children counts; can be extended for other GETs.
- */
-export declare class FailedRequestCache {
-    private readonly map;
-    /** Errors from {@link ViewCacheManager.getOrCreateChildren} */
-    static childrenViewKey(pKey: string, qKey: string): string;
-    /** Errors from {@link TreeCache.getChildrenCount} */
-    static childrenCountKey(normalizedParentKey: string): string;
-    /**
-     * Returns the cached error if still within TTL, otherwise null (entry may be removed).
-     */
-    getFreshError(key: string, errorTtlMs: number): unknown | null;
-    setError(key: string, error: unknown): void;
-    delete(key: string): void;
-    /** All list-view errors for one parent bucket (pKey). */
-    clearChildrenViewErrorsForParent(pKey: string): void;
-    clearAll(): void;
-}

package/file-manager/adapters/MutationRegistry.d.ts

@@ -1,6 +0,0 @@
-export declare class MutationRegistry {
-    private readonly deletingIds;
-    beginDeleting(ids: Iterable<string>): void;
-    endDeleting(ids: Iterable<string>): void;
-    isDeleting(id: string | null | undefined): boolean;
-}

package/file-manager/adapters/PathAwareStorageAdapter.d.ts

@@ -1,71 +0,0 @@
-import type { FileSystemItem, StorageProvider, FileSystemItemUpdate, GetFileDataOptions, MayBePromise, StorageProviderController, BatchResult, StorageUploadFilesRequest as UploadFilesRequest, StorageSortState as SortState, StorageApiPaginationResponse as ApiPaginationResponse } from '../types/storage';
-export declare class PathAwareStorageAdapter implements StorageProvider {
-    private readonly _inner;
-    readonly rootPath: string;
-    readonly trashId: string;
-    readonly trashPath: string;
-    readonly ensureFolderTrailingSlash: boolean;
-    private readonly _pathToId;
-    private readonly _idToPath;
-    getUrl?: (file: FileSystemItem) => MayBePromise<string>;
-    getThumbnailUrl?: (file: FileSystemItem) => MayBePromise<string>;
-    validateDuplicates?: boolean;
-    constructor(_inner: StorageProvider, rootPath?: string, trashId?: string, trashPath?: string, ensureFolderTrailingSlash?: boolean);
-    setController(controller: StorageProviderController): void;
-    clearCache?(pathFolder?: string | null): MayBePromise<void>;
-    findItemByPath?(path: string): MayBePromise<FileSystemItem | undefined>;
-    private _getOrGenerateId;
-    pathForId(id: string, isFolder: boolean, silent?: boolean): string;
-    private _updateIdMapping;
-    getItems(options: {
-        folderId?: string;
-        search?: string;
-        sortBy?: SortState['sortBy'];
-        sortOrder?: SortState['sortOrder'];
-        page?: number;
-        limit?: number;
-        itemType: 'all' | 'file' | 'folder';
-    }): Promise<{
-        items: FileSystemItem[];
-        pagination?: Partial<ApiPaginationResponse>;
-    }>;
-    createFolder(name: string, parent?: string, is_force_create?: boolean): Promise<FileSystemItem>;
-    renameItem(item: FileSystemItem, newName: string): Promise<FileSystemItemUpdate>;
-    deleteItem(item: FileSystemItem, options: {
-        permanent: boolean;
-    }): Promise<void>;
-    uploadFile(file: {
-        name: string;
-        size: number;
-        type: string;
-        folderId?: string | null;
-        data: Blob | globalThis.File;
-        thumbnail?: string;
-        dimensions?: string;
-        aspectRatio?: string;
-        extension?: string;
-    }): Promise<FileSystemItemUpdate>;
-    uploadFiles(request: UploadFilesRequest): Promise<BatchResult<FileSystemItem>>;
-    findFileByUrl(url: string, folderId?: string): Promise<FileSystemItem | undefined>;
-    uploadFileByUrl(url: string, folderId?: string | null, options?: {
-        eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif';
-    }): Promise<FileSystemItem>;
-    moveItem(item: FileSystemItem, targetFolderId?: string): Promise<FileSystemItemUpdate>;
-    moveItems(items: FileSystemItem[], targetFolderId?: string): Promise<BatchResult<FileSystemItemUpdate>>;
-    copyItems(items: FileSystemItem[], targetFolderId?: string): Promise<BatchResult<FileSystemItemUpdate>>;
-    deleteItems(items: FileSystemItem[], options: {
-        permanent: boolean;
-    }): Promise<BatchResult<never>>;
-    private remapCachedFolderContents;
-    private recursivelyRemoveMappings;
-    copyItem(item: FileSystemItem, targetFolderId?: string): Promise<FileSystemItemUpdate>;
-    updateFile(file: FileSystemItem, updates: {
-        name?: string;
-        data?: Blob | string;
-    }): Promise<FileSystemItemUpdate>;
-    getFileData(file: FileSystemItem, options?: GetFileDataOptions): Promise<Blob>;
-    cleanTrash(): Promise<{
-        success: boolean;
-        deletedCount?: number;
-    }>;
-}

package/file-manager/adapters/PathAwareStorageAdapter.trash.test.d.ts

@@ -1 +0,0 @@
-export {};

package/file-manager/adapters/TreeCache.d.ts

@@ -1,170 +0,0 @@
-import type { FileSystemItem } from '../types/storage';
-import type { ChildrenQueryParams, ViewStrategyOptions } from './cacheViewTypes';
-import { FailedRequestCache } from './FailedRequestCache';
-export type { ChildrenQueryParams, ViewStrategyOptions } from './cacheViewTypes';
-export interface QueryResult<T> {
-    items: T[];
-    total?: number;
-    totalPages?: number;
-    page?: number;
-    limit?: number;
-    [key: string]: unknown;
-}
-/** When `fileManager.cacheStrategy.ttl` is unset: success/error cache and notification dedupe fallback (30 min). */
-export declare const DEFAULT_FILE_MANAGER_CACHE_TTL_MS: number;
-/**
- * Configuration for {@link TreeCache}.
- */
-export interface TreeCacheConfig {
-    ttl?: number;
-    errorTtl?: number;
-    /**
-     * Predicate: which errors count as "folder not found" (for negative cache / empty result).
-     * Default: checks error.code === 'folder_not_found' | 'path_folder_not_found' | 'FolderNotFound',
-     * or error.status === 404.
-     */
-    isFolderNotFoundError?: (err: unknown) => boolean;
-}
-/** Default predicate for "folder not found" errors. Can be overridden via {@link TreeCacheConfig.isFolderNotFoundError}. */
-export declare function defaultIsFolderNotFoundError(error: unknown): boolean;
-export declare class EntityCacheManager {
-    private readonly entities;
-    private readonly childrenByParent;
-    private readonly maxCacheSize;
-    private now;
-    private checkCacheSize;
-    getEntity(id: string): FileSystemItem | undefined;
-    getRecord(id: string): {
-        value: FileSystemItem;
-        updatedAt: number;
-    } | undefined;
-    getFileSystemItem(id: string): FileSystemItem | undefined;
-    getFolder(id: string): FileSystemItem | undefined;
-    getChildrenIds(parentId: string | null, opts?: {
-        onlyFileSystemItems?: boolean;
-        onlyFolders?: boolean;
-    }): string[];
-    searchByUrl(url: string): FileSystemItem | null;
-    upsertEntity(entity: FileSystemItem): void;
-    updateServerChildrenCount(folderId: string | null, serverCount: number | undefined): void;
-    deleteEntityById(id: string): {
-        entity: FileSystemItem | null;
-        parentId: string | null;
-    };
-    deleteFolderRecursive(folderId: string): {
-        deletedFolderRecords: FileSystemItem[];
-        deletedFileSystemItemRecords: FileSystemItem[];
-    };
-    moveEntityById(entityId: string, targetParentId: string | null): FileSystemItem | null;
-    copyFileSystemItem(fileId: string, newId: string, targetFolderId: string | null): FileSystemItem | null;
-    copyFolderShallow(folderId: string, newId: string, targetParentId: string | null): FileSystemItem | null;
-    isEntityStale(id: string, ttlMs: number): boolean;
-    touch(id: string, at?: number): void;
-    getEntitiesByIds<T extends FileSystemItem>(ids: string[]): (T | null)[];
-    searchByName(searchQuery: string, options?: {
-        parentId?: string | null;
-        recursive?: boolean;
-        itemType?: 'file' | 'folder' | 'all';
-        caseSensitive?: boolean;
-        limit?: number;
-    }): FileSystemItem[];
-    toJSON(): any;
-    static fromJSON(data: any): EntityCacheManager;
-}
-export declare class ViewCacheManager {
-    private readonly views;
-    private readonly strategy;
-    private readonly ttl;
-    private readonly errorTtl;
-    private readonly entityTtl;
-    private readonly failedRequests;
-    private readonly isFolderNotFoundError;
-    private serverChildrenCountHandler?;
-    private childrenCountInvalidator?;
-    private readonly maxViewsPerParent;
-    constructor(options?: ViewStrategyOptions, ttl?: number, errorTtl?: number, entityTtl?: number, failedRequests?: FailedRequestCache, isFolderNotFoundError?: (err: unknown) => boolean);
-    setServerChildrenCountHandler(handler: (parentId: string | null, total: number | undefined, entitiesManager: EntityCacheManager) => void): void;
-    setChildrenCountInvalidator(handler: (parentId: string | null | undefined) => void): void;
-    private now;
-    private parentKey;
-    private isExpired;
-    private areEntitiesStale;
-    private isEntityTypeCompatible;
-    /** Mark cached view as stale and cancel any in-flight load for this record. */
-    private markViewStaleForReload;
-    private cleanupOldViews;
-    getOrCreateChildren(parentId: string | null, params: ChildrenQueryParams, loader: (parentId: string | null, params: ChildrenQueryParams) => Promise<QueryResult<FileSystemItem>>, entitiesManager: EntityCacheManager): Promise<QueryResult<FileSystemItem>>;
-    /**
-     * Асинхронно предзагружает соседние страницы
-     * Проверяет loadId основного view перед применением результатов
-     */
-    private preloadPagesAsync;
-    private removeEmptyPageIfNeeded;
-    private updateTotalPagesForAllViews;
-    private isParamsSame;
-    private syncTotalsInSameViews;
-    private cascadeShiftPages;
-    private cascadeShiftToNextPage;
-    /** Whether the entity carries the field this sorted view is ordered by. */
-    private canCompareInSortedView;
-    private tryInsertSorted;
-    private updateChildrenCountForOperation;
-    private adjustChildrenCount;
-    smartInvalidateChildrenViews(parentId: string | null, entity: FileSystemItem | null, operation: 'insert' | 'delete' | 'move' | 'copy' | 'update', entitiesManager: EntityCacheManager, prevParentId?: string | null, prevEntity?: FileSystemItem | null): void;
-    private shouldInvalidateCompletely;
-    private tryReinsertEntity;
-    private handleDelete;
-    private handleInsert;
-    private handleUpdate;
-    private handleMove;
-    forceInvalidateChildrenViews(parentId: string | null): void;
-    getKnownTotal(parentId: string | null): number | undefined;
-    toJSON(): any;
-    static fromJSON(data: any, opts?: {
-        failedRequests?: FailedRequestCache;
-        ttl?: number;
-        errorTtl?: number;
-        isFolderNotFoundError?: (err: unknown) => boolean;
-    }): ViewCacheManager;
-}
-export declare class TreeCache {
-    private readonly entities;
-    private readonly views;
-    private readonly ttl;
-    private readonly errorTtl;
-    private readonly failedRequests;
-    private readonly isFolderNotFoundError;
-    private readonly childrenCountPromises;
-    private invalidateChildrenCountCache;
-    constructor(viewOptions?: ViewStrategyOptions, ttl?: number, errorTtl?: number, config?: TreeCacheConfig);
-    getEntity(id: string): FileSystemItem | null;
-    getFileSystemItem(id: string): FileSystemItem | null;
-    getFolder(id: string): FileSystemItem | null;
-    getOrCreateChildren(parentId: string | null, params: ChildrenQueryParams, loader: (parentId: string | null, params: ChildrenQueryParams) => Promise<QueryResult<FileSystemItem>>): Promise<QueryResult<FileSystemItem>>;
-    upsertEntity(entity: FileSystemItem): void;
-    private isAncestor;
-    moveEntity(entityId: string, targetParentId: string | null): FileSystemItem | null;
-    copyEntity(entityId: string, targetParentId: string | null, newId?: string, overrides?: Partial<FileSystemItem>): FileSystemItem | null;
-    searchByUrl(url: string): FileSystemItem | null;
-    deleteEntity(entityId: string): FileSystemItem | null;
-    deleteFolderRecursive(folderId: string): {
-        deletedFileSystemItemIds: string[];
-        deletedFolderIds: string[];
-    };
-    forceInvalidate(id: string): void;
-    /** Сбрасывает закэшированные листинги папки, даже если entity папки ещё нет в графе. */
-    invalidateListingViews(folderId: string | null | undefined): void;
-    getChildrenIds(parentId: string | null): string[];
-    searchByName(searchQuery: string, options?: {
-        parentId?: string | null;
-        recursive?: boolean;
-        itemType?: 'file' | 'folder' | 'all';
-        caseSensitive?: boolean;
-        limit?: number;
-    }): FileSystemItem[];
-    getChildrenCount(folderId?: string, loader?: (folderId: string) => Promise<number>): Promise<number>;
-    toJSON(): any;
-    static fromJSON(data: any, viewOptions?: ViewStrategyOptions, config?: TreeCacheConfig): TreeCache;
-    private handleServerReportedChildrenCount;
-    private checkAndResolveChildrenCountConflict;
-}

package/file-manager/adapters/TreeCache.forceInvalidate.test.d.ts

@@ -1 +0,0 @@
-export {};

package/file-manager/adapters/TreeCache.sortedView.test.d.ts

@@ -1 +0,0 @@
-export {};

package/file-manager/adapters/cacheViewStrategy.d.ts

@@ -1,40 +0,0 @@
-import type { FileSystemItem } from '../types/storage';
-import type { ChildrenQueryParams, ViewStrategyOptions } from './cacheViewTypes';
-type SortOrder = 'asc' | 'desc';
-/**
- * Resolve sort field defaults for cache compare vs client-side sort callers.
- * - sortBy omitted → name
- * - sortOrder omitted + sortBy explicitly set → desc (matches getFiles server default)
- * - both omitted → asc (legacy client-side default)
- */
-export declare function resolveSortParams(params?: ChildrenQueryParams): {
-    sortBy: string;
-    sortOrder: SortOrder;
-};
-/**
- * Compare two file-system items for sorted view cache maintenance.
- * Aligns with {@link DataSourceProxyBase} client-side sort and default server sort params.
- */
-export declare function compareFileSystemItems(a: FileSystemItem, b: FileSystemItem, params?: ChildrenQueryParams): number;
-/**
- * Whether an entity carries the field the cached view is sorted by.
- * Reads the same fields as {@link compareFileSystemItems}: without them the
- * comparator silently falls back to defaults (missing date → epoch) and the
- * entity lands at an arbitrary position.
- */
-export declare function hasComparableSortValue(entity: FileSystemItem, params?: ChildrenQueryParams): boolean;
-/**
- * Whether an entity belongs in a cached children view with optional search filter.
- */
-export declare function matchesChildrenViewFilter(entity: FileSystemItem, params?: ChildrenQueryParams): boolean;
-/** Default comparator for sorted view cache updates. */
-export declare const defaultFileSystemItemComparator: typeof compareFileSystemItems;
-/** Default search filter for cached children views. */
-export declare const defaultChildrenViewFilterMatch: typeof matchesChildrenViewFilter;
-/** Default sort-value guard for sorted view cache updates. */
-export declare const defaultHasSortValue: typeof hasComparableSortValue;
-/**
- * Merge user cache strategy with package defaults for comparator, filterMatch and hasSortValue.
- */
-export declare function resolveViewStrategyOptions(options?: ViewStrategyOptions): ViewStrategyOptions;
-export {};

package/file-manager/adapters/cacheViewStrategy.test.d.ts

@@ -1 +0,0 @@
-export {};

package/file-manager/adapters/cacheViewTypes.d.ts

@@ -1,24 +0,0 @@
-import type { FileSystemItem } from '../types/storage';
-export interface ChildrenQueryParams {
-    page?: number;
-    pageSize?: number | string;
-    sortBy?: string;
-    sortOrder?: string;
-    search?: string;
-    itemType?: 'file' | 'folder' | 'all';
-    [key: string]: unknown;
-}
-export interface ViewStrategyOptions {
-    allowSortedInsert?: boolean;
-    allowSearchInsert?: boolean;
-    invalidateOnPaginationFull?: boolean;
-    preloadPagesBefore?: number;
-    preloadPagesAfter?: number;
-    comparator?: (a: FileSystemItem, b: FileSystemItem, params?: ChildrenQueryParams) => number;
-    filterMatch?: (entity: FileSystemItem, params?: ChildrenQueryParams) => boolean;
-    /**
-     * Guard for sorted inserts: entities without the sort field are not inserted
-     * blindly, the view is refetched instead. Override together with comparator.
-     */
-    hasSortValue?: (entity: FileSystemItem, params?: ChildrenQueryParams) => boolean;
-}

package/file-manager/adapters/systemFolderPath.d.ts

@@ -1,27 +0,0 @@
-import type { FileSystemItem } from '../types/storage';
-/** Tree/cache sentinel id for the trash folder (matches `FolderTree` node key and `TRASH` constant). */
-export declare const TRASH_FOLDER_ID: 'Trash';
-export type SystemFolderDefinition = {
-    id: string;
-    name?: string;
-    folderId?: string | null;
-};
-/** Normalize a logical folder path for system-folder lookup (`Trash`, `/Trash/`, `foo\\bar`). */
-export declare function normalizeSystemFolderPath(path: string): string;
-/**
- * Lookup keys to try with {@link StorageProvider.findItemByPath} for trash system paths.
- * Adds trash sentinel aliases when `requestPath` normalizes to the configured `trashPath`.
- */
-export declare function getTrashFolderLookupCandidates(requestPath: string, trashPath: string, trashFolderId?: string): string[];
-/**
- * Factory for {@link StorageProvider.findItemByPath} — maps logical paths to synthetic folders
- * (backend-managed trash, etc.) without creating physical folders on the server.
- *
- * @example
- * ```ts
- * findItemByPath: createSystemFolderByPathResolver({
- *   Trash: { id: TRASH_FOLDER_ID, folderId: rootId },
- * }),
- * ```
- */
-export declare function createSystemFolderByPathResolver(folders: Record<string, SystemFolderDefinition>): (path: string) => FileSystemItem | undefined;