@emailmaker/filemanager 1.1.85-dev.1 → 1.1.85-dev.11

package/helpers/imageEditorTranslations.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Translations for `react-filerobot-image-editor` in the given locale.
+ * Unknown locales fall back to English, which is what the editor ships by default.
+ */
+export declare function getImageEditorTranslations(locale?: string): Record<string, string>;

package/hooks/core/files/useFilesAPI.d.ts

@@ -26,7 +26,7 @@ export interface UseFilesAPIActions {
             }>;
         }) => void;
     }) => Promise<void>;
-    handleAddFileByUrl: (url?: string | null, noFolder?: boolean, suppressNotifications?: boolean, eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif', preferredFileName?: string) => Promise<AppFile | void>;
+    handleAddFileByUrl: (url?: string | null, noFolder?: boolean, suppressNotifications?: boolean, eventSource?: 'upload' | 'uploadByUrl' | 'imageEditor' | 'iconStock' | 'imageStock' | 'gif', preferredFileName?: string) => Promise<AppFile | void>;
     handleDroppedFiles: (droppedFiles: globalThis.File[]) => Promise<void>;
     getFileData: (fileId: string, silent?: boolean) => Promise<Blob | undefined>;
     findFileByUrl: (url: string, silent?: boolean) => Promise<AppFile | null>;

package/hooks/core/useFiles.d.ts

@@ -35,7 +35,7 @@ export interface UseFilesActions {
             }>;
         }) => void;
     }) => Promise<void>;
-    handleAddFileByUrl: (url?: string | null, noFolder?: boolean, suppressNotifications?: boolean, eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif', preferredFileName?: string) => Promise<AppFile | void>;
+    handleAddFileByUrl: (url?: string | null, noFolder?: boolean, suppressNotifications?: boolean, eventSource?: 'upload' | 'uploadByUrl' | 'imageEditor' | 'iconStock' | 'imageStock' | 'gif', preferredFileName?: string) => Promise<AppFile | void>;
     toggleFileSelection: (fileId: string, opts?: {
         metaKey?: boolean;
         ctrlKey?: boolean;

package/hooks/index.d.ts

@@ -1,6 +1,6 @@
 export * from './core';
 export { useFileActions } from './useFileActions';
-export { usePixieEditor } from './usePixieEditor';
+export { useFilerobotEditor } from './useFilerobotEditor';
 export { useLastDirectory } from './useLastDirectory';
 export { useControlledImageLoader } from './useControlledImageLoader';
 export { useProxyDisplayFallback } from './useProxyDisplayFallback';

package/hooks/useFilerobotEditor.d.ts

@@ -0,0 +1,16 @@
+import type { FilerobotSavePayload } from '../types';
+import { File as AppFile, FilesQueryParams, ThumbnailFile } from '../types';
+interface UseFilerobotEditorProps {
+    files: AppFile[];
+    fetchFiles: (params?: FilesQueryParams) => Promise<void>;
+    selectedFolder: string | null;
+}
+export declare const useFilerobotEditor: ({ files, fetchFiles, selectedFolder }: UseFilerobotEditorProps) => {
+    isFilerobotEditorVisible: boolean;
+    editingFile: AppFile | ThumbnailFile | null;
+    handleEdit: (fileForEdit?: ThumbnailFile | AppFile) => void;
+    handleFilerobotEditorSave: (updatedFile: AppFile, payload: FilerobotSavePayload) => Promise<AppFile | undefined>;
+    handleFilerobotEditorSaveCopy: (updatedFile: AppFile, payload: FilerobotSavePayload) => Promise<AppFile | undefined>;
+    handleFilerobotEditorClose: () => void;
+};
+export {};

package/index.d.ts

@@ -1,10 +1,10 @@
-import { init, unmount, FileManagerAppWithContext, initPixieEditor, unmountPixieEditor, initFileManager, PixieOnlyApp } from './file-manager';
-export { init, unmount, FileManagerAppWithContext, PixieOnlyApp, initPixieEditor, unmountPixieEditor, initFileManager };
+import { init, unmount, FileManagerAppWithContext, initFilerobotEditor, unmountFilerobotEditor, initFileManager, FilerobotOnlyApp } from './file-manager';
+export { init, unmount, FileManagerAppWithContext, FilerobotOnlyApp, initFilerobotEditor, unmountFilerobotEditor, initFileManager };
 declare const _default: {
     init: typeof init;
     unmount: typeof unmount;
-    initPixieEditor: typeof initPixieEditor;
-    unmountPixieEditor: typeof unmountPixieEditor;
+    initFilerobotEditor: typeof initFilerobotEditor;
+    unmountFilerobotEditor: typeof unmountFilerobotEditor;
     initFileManager: typeof initFileManager;
 };
 export default _default;
@@ -17,6 +17,7 @@ export { type Folder, type File, type PathItem, type MenuItem, type FileManagerO
 export { FileManagerApiError } from './shared/fileManagerApiError';
 export { mapHttpStatusToErrorCode } from './shared/mapHttpStatusToErrorCode';
 export { buildAssetsPath, joinUrls, getAssetsBase } from './helpers/urls';
+export { getImageEditorTranslations } from './helpers/imageEditorTranslations';
 export { FailedRequestCache } from './adapters/FailedRequestCache';
 export { MutationRegistry } from './adapters/MutationRegistry';
 export { compareFileSystemItems, defaultChildrenViewFilterMatch, defaultFileSystemItemComparator, defaultHasSortValue, hasComparableSortValue, matchesChildrenViewFilter, resolveSortParams, resolveViewStrategyOptions, } from './adapters/cacheViewStrategy';
@@ -26,4 +27,4 @@ export { DataSourceProxyBase, type DataSourceProxyConfig, type DataSourceProxyOp
 export { PathAwareStorageAdapter } from './adapters/PathAwareStorageAdapter';
 export type { StorageProvider, StorageProviderController, FileSystemItem, FileSystemItemUpdate, GetFileDataOptions, BatchResult as StorageBatchResult, OperationResult as StorageOperationResult, FileManagerApiErrorInfo, StorageApiPaginationResponse, StorageSortState, StorageUploadFileItemInput, StorageUploadFilesRequest, MayBePromise, } from './types/storage';
 export { fetchRemoteImageBlobByUrl, type FetchRemoteImageBlobOptions, type RemoteFileFetchHandlers, type RemoteFileFetchIntent, } from './utils/remoteFileFetchPipeline';
-export { type InitPixieEditorOptions, type Options as FileManagerInitOptions, type UniversalInitOptions, } from './file-manager';
+export { type InitFilerobotEditorOptions, type Options as FileManagerInitOptions, type UniversalInitOptions, } from './file-manager';

package/notification.d.ts

@@ -287,7 +287,7 @@ export namespace Notify {
   /**
    * Source of the upload event: 'upload' for file picker/drag-drop, 'uploadByUrl' for URL upload.
    */
-  export type UploadEventSource = 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif';
+  export type UploadEventSource = 'upload' | 'uploadByUrl' | 'imageEditor' | 'iconStock' | 'imageStock' | 'gif';
 
   /**
    * Payload for file upload operations.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emailmaker/filemanager",
-  "version": "1.1.85-dev.1",
+  "version": "1.1.85-dev.11",
   "main": "./file-manager.js",
   "module": "./file-manager.esm.js",
   "types": "./index.d.ts",
@@ -24,8 +24,8 @@
     "./notification": {
       "types": "./notification.d.ts"
     },
-    "./pixie-editor": {
-      "import": "./file-manager-PixieEditor.js"
+    "./image-editor": {
+      "import": "./file-manager-FilerobotEditor.js"
     },
     "./package.json": "./package.json",
     "./*": "./*"
@@ -37,7 +37,6 @@
     "@ant-design/icons": "^6.1.0",
     "antd": "^6.4.3",
     "browser-image-compression": "^2.0.2",
-    "pixie": "*",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "@untitledui/icons": "^0.0.22"

package/types/storage.d.ts

@@ -336,7 +336,7 @@ export interface StorageProvider {
      * @returns The uploaded or existing complete file object
      */
     uploadFileByUrl: (url: string, folderId?: string, options?: {
-        eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif';
+        eventSource?: 'upload' | 'uploadByUrl' | 'imageEditor' | 'iconStock' | 'imageStock' | 'gif';
     }) => MayBePromise<FileSystemItem>;
     /**
      * Delete multiple items (files or folders).

package/types.d.ts

@@ -1,5 +1,6 @@
 import React, { ReactNode, RefObject } from 'react';
 import type { FormInstance } from 'antd';
+import type { IconifyJSON } from '@iconify/types';
 import { MY_FILES, GIF, STOCK_IMAGES, ICONS, AI, IMAGE_CODES, EDITOR, IMAGE_EXTENSIONS } from './constants';
 import type { InputRef } from 'antd';
 import type { TextAreaRef } from 'antd/es/input/TextArea';
@@ -41,15 +42,15 @@ export interface File {
     sourceUrl?: string;
     saveWithoutFolder?: boolean;
 }
-export interface PixieSavePayload {
+export interface FilerobotSavePayload {
     blob: UploadBinary;
     mimeType: string;
     thumbnail: string;
     /** Обычное сохранение или «Сохранить как копию». */
     mode: 'save' | 'saveCopy';
 }
-/** Передаётся вторым аргументом в `onEditorOk` после сохранения из Pixie. */
-export type EditorSaveMeta = Pick<PixieSavePayload, 'mode'>;
+/** Передаётся вторым аргументом в `onEditorOk` после сохранения из Filerobot. */
+export type EditorSaveMeta = Pick<FilerobotSavePayload, 'mode'>;
 export interface PathItem {
     id: string;
     name: string;
@@ -290,7 +291,7 @@ export interface FileManagerDataProviders {
         noFolder?: boolean;
         name?: string;
         /** Источник события загрузки для аналитики */
-        eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif';
+        eventSource?: 'upload' | 'uploadByUrl' | 'imageEditor' | 'iconStock' | 'imageStock' | 'gif';
     }) => Promise<File>;
     deleteItems?: (items: string[], options?: {
         permanent?: boolean;
@@ -479,7 +480,7 @@ export interface Config {
     /** Наличие пагинации на бэкенде (отображение постраничности и т.п.). */
     paginationAvailable?: boolean;
     /**
-     * Клиент устраняет дубликаты имён при загрузке, копии из Pixie, URL, batch, copy/move, создании папки.
+     * Клиент устраняет дубликаты имён при загрузке, копии из Filerobot, URL, batch, copy/move, создании папки.
      * Отдельно от настроек пагинации (`disablePagination`, `hasPagination`, `paginationAvailable`).
      */
     dedupeUploadNamesOnClient?: boolean;
@@ -490,7 +491,7 @@ export interface Config {
      */
     previewFallbackToFileUrl?: boolean;
     /**
-     * Сохранять копию из Pixie в текущую папку исходного файла.
+     * Сохранять копию из Filerobot в текущую папку исходного файла.
      * По умолчанию copy-save идёт через `noFolder` во временную папку на стороне хоста.
      */
     saveCopyToCurrentFolder?: boolean;
@@ -563,6 +564,11 @@ export interface Config {
      * neither split nor shake. Defaults to `static/media/icon-sets`.
      */
     iconSetsUrl?: string;
+    /**
+     * Host loader of an icon set (`lucide`, `tabler`). When given, `iconSetsUrl` and the packaged files are not used:
+     * the host delivers the sets as its own modules and nothing is fetched.
+     */
+    loadIconSet?: (prefix: 'lucide' | 'tabler') => Promise<IconifyJSON>;
     /** Counters and limits */
     counters?: Counters;
     limits?: Limits;
@@ -586,6 +592,11 @@ export interface Config {
     rememberLastFolder?: boolean;
     compressMaxSize?: number;
     compressMaxWidthOrHeight?: number;
+    /**
+     * Squeeze image editor results to `compressMaxSize` too. Off by default: the result is only downscaled
+     * beyond `compressMaxWidthOrHeight`, otherwise every save would shrink the image again.
+     */
+    compressEditedImages?: boolean;
     /** URL локальной копии browser-image-compression для web worker. */
     compessorUrl?: string;
     /** Alias для compessorUrl с корректным написанием. */

package/utils/blankImage.d.ts

@@ -0,0 +1,10 @@
+/** Default size of a blank editor canvas: roughly an email-wide banner. */
+export declare const BLANK_IMAGE_WIDTH = 800;
+export declare const BLANK_IMAGE_HEIGHT = 600;
+/** A 1×1 transparent PNG: used where a canvas cannot be drawn (no DOM, no 2D context). */
+export declare const BLANK_PNG_FALLBACK = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYGD4DwABBAEAwS2OUAAAAABJRU5ErkJggg==";
+/**
+ * createBlankImageDataUrl returns a transparent PNG to open the image editor on when there is no
+ * image yet (a freshly added placeholder): Filerobot cannot start without a source.
+ */
+export declare function createBlankImageDataUrl(width?: number, height?: number): string;

package/utils/blankImage.test.d.ts

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

package/utils/dedupeUploadNamesOnClient.d.ts

@@ -1,6 +1,6 @@
 import type { Config } from '../types';
 /**
  * Флаг `Config.dedupeUploadNamesOnClient`: клиент подбирает уникальные имена при загрузке,
- * копии из Pixie, upload по URL, batch, copy/move, создании папки.
+ * копии из Filerobot, upload по URL, batch, copy/move, создании папки.
  */
 export declare function isDedupeUploadNamesOnClientEnabled(config?: Pick<Config, 'dedupeUploadNamesOnClient'>): boolean;

package/utils/fileFormatUtils.d.ts

@@ -1,10 +1,10 @@
 export type ImageFormat = 'jpeg' | 'png' | 'gif' | 'webp' | 'svg';
-export type PixieFormat = 'jpeg' | 'png' | 'json' | 'svg';
+export type FilerobotFormat = 'jpeg' | 'png' | 'json' | 'svg';
 export interface FileFormatInfo {
     extension: string;
     mimeType: string;
     format: ImageFormat;
-    pixieFormat: PixieFormat;
+    filerobotFormat: FilerobotFormat;
 }
 /**
  * Определяет формат файла из нескольких источников с правильным приоритетом

package/utils/{pixieEditorConfig.d.ts → filerobotEditorConfig.d.ts}

@@ -1,15 +1,16 @@
 import type { Config } from '../types';
 /**
- * Options of the standalone Pixie editor that become the `Config` its provider serves.
- * Split out of `InitPixieEditorOptions` so the mapping below can be covered by tests.
+ * Options of the standalone image editor that become the `Config` its provider serves.
+ * Split out of `InitFilerobotEditorOptions` so the mapping below can be covered by tests.
  */
-export interface PixieEditorConfigOptions {
+export interface FilerobotEditorConfigOptions {
     theme?: Config['theme'];
     locale?: string;
     baseUrl?: string;
     assetsUrl?: string;
     compressMaxSize?: Config['compressMaxSize'];
     compressMaxWidthOrHeight?: Config['compressMaxWidthOrHeight'];
+    compressEditedImages?: Config['compressEditedImages'];
     compessorUrl?: string;
     compressorUrl?: string;
     showNotifications?: boolean;
@@ -31,8 +32,8 @@ export interface PixieEditorConfigOptions {
     enableUpdateFile?: boolean;
 }
 /**
- * buildPixieEditorConfig maps standalone editor options onto the `Config` its provider serves.
+ * buildFilerobotEditorConfig maps standalone editor options onto the `Config` its provider serves.
  * The standalone editor has no `FileManagerApp` to assemble that config, so an option missed
  * here is dropped silently — the editor simply falls back to defaults.
  */
-export declare function buildPixieEditorConfig(options: PixieEditorConfigOptions): Config;
+export declare function buildFilerobotEditorConfig(options: FilerobotEditorConfigOptions): Config;

package/utils/filerobotEditorConfig.test.d.ts

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

package/utils/imageCompression.d.ts

@@ -10,3 +10,13 @@ export interface PrepareImageForUploadOptions {
 }
 export declare function prepareImageForUpload(file: File, options?: PrepareImageForUploadOptions): Promise<File>;
 export declare const compressImageWithLimits: typeof prepareImageForUpload;
+/** Options of `prepareEditedImageForUpload`. */
+export interface PrepareEditedImageOptions extends PrepareImageForUploadOptions {
+    /** Squeeze the result to `maxSizeMB` like a new upload; set when the host configured the limit explicitly. */
+    compressBySize?: boolean;
+}
+/**
+ * Prepares an image editor result for upload: by default downscales only beyond maxWidthOrHeight and ignores the size limit,
+ * because re-running the upload compression on every save shrank the resolution and coarsened PNGs each time.
+ */
+export declare function prepareEditedImageForUpload(file: File, options?: PrepareEditedImageOptions): Promise<File>;

package/utils/imageCompression.editedImage.test.d.ts

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

package/utils/jsonDataProvider.d.ts

@@ -53,7 +53,7 @@ export declare class JSONDataProvider implements FileManagerDataProviders {
         folderId?: string | null;
         noFolder?: boolean;
         name?: string;
-        eventSource?: 'upload' | 'uploadByUrl' | 'pixie' | 'iconStock' | 'imageStock' | 'gif';
+        eventSource?: 'upload' | 'uploadByUrl' | 'imageEditor' | 'iconStock' | 'imageStock' | 'gif';
     }) => Promise<File>;
     updateFile: (fileId: string, updates: {
         name?: string;

package/utils/libraryTabRequest.d.ts

@@ -0,0 +1,7 @@
+import type { LibraryMenuKey } from '../types';
+/**
+ * resolveLibraryTabRequest returns the tab to switch to when the host's requested tab changes, or
+ * undefined when there is nothing to apply. The request is a command, not a state to hold: repeating
+ * it on every config rebuild would pull the user away from a tab they opened themselves.
+ */
+export declare function resolveLibraryTabRequest(appliedRequest: LibraryMenuKey | undefined, nextRequest: LibraryMenuKey | undefined, isOpenable: (tab: LibraryMenuKey) => boolean): LibraryMenuKey | undefined;

package/utils/libraryTabRequest.test.d.ts

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