@emailmaker/filemanager 1.1.93 → 1.1.102

package/components/FilerobotEditor/FilerobotEditor.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { FilerobotSavePayload } from '../../types';
 import { File as AppFile, ThumbnailFile } from '../../types';
+export { useCornerRadiusSync } from './cornerRadius/useCornerRadiusSync';
 export interface FilerobotEditorProps {
     visible: boolean;
     onClose?: () => void;

package/components/FilerobotEditor/cornerRadius/CornerRadiusTool.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import { type CornerRadiusState } from './cornerRadiusMath';
+type Translate = (key: string) => string;
+/** CornerRadiusToolConfig is the editor config entry the tool reports its state through. */
+export interface CornerRadiusToolConfig {
+    onChange?: (state: CornerRadiusState) => void;
+}
+/**
+ * CornerRadiusItem is the toolbar button. It also reports the tool state to the editor wrapper: it is
+ * mounted for the whole adjust tab, so live slider changes, which the editor's `onModify` never sees,
+ * reach the wrapper too.
+ */
+export declare const CornerRadiusItem: React.FC<{
+    selectTool: (id: string, event?: unknown) => void;
+    t: Translate;
+    isSelected?: boolean;
+}>;
+/** CornerRadiusOptions is the panel above the toolbar: a slider and a pixel field bound to each other. */
+export declare const CornerRadiusOptions: React.FC<{
+    t: Translate;
+}>;
+export {};

package/components/FilerobotEditor/cornerRadius/__tests__/cornerRadiusMath.test.d.ts

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

package/components/FilerobotEditor/cornerRadius/__tests__/cornerRadiusOutput.test.d.ts

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

package/components/FilerobotEditor/cornerRadius/__tests__/imageEditorTools.test.d.ts

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

package/components/FilerobotEditor/cornerRadius/cornerRadiusEraser.d.ts

@@ -0,0 +1,17 @@
+import Konva from 'konva';
+/** CornerRadiusEraserParams describe what the eraser cuts off. */
+export interface CornerRadiusEraserParams {
+    /** Radius in pixels of the final image; 0 erases nothing. */
+    radius: number;
+    /** Width the image is resized to, or 0 when it keeps its size. */
+    resizeWidth: number;
+    /** Hides the cut on screen (the crop tool shows the whole image); saving still applies it. */
+    suspended: boolean;
+}
+/** findEditorStage returns the editor's Konva stage rendered inside the container. */
+export declare function findEditorStage(container: Element | null | undefined): Konva.Stage | undefined;
+/**
+ * applyCornerRadius puts an eraser on top of both image layers and updates it. The eraser is part of
+ * the stage, so the editor's export, which clones the stage, bakes the same corners into the file.
+ */
+export declare function applyCornerRadius(stage: Konva.Stage, params: CornerRadiusEraserParams): void;

package/components/FilerobotEditor/cornerRadius/cornerRadiusMath.d.ts

@@ -0,0 +1,38 @@
+/** CORNER_RADIUS_TOOL_ID is the image editor tool id of the corner radius tool. */
+export declare const CORNER_RADIUS_TOOL_ID = "CornerRadius";
+/** ELLIPSE_CROP is the editor's crop ratio of the ellipse frame. */
+export declare const ELLIPSE_CROP = "ellipse";
+/** CORNER_RADIUS_TRANSLATION_KEYS are the editor dictionary keys the tool adds. */
+export declare const CORNER_RADIUS_TRANSLATION_KEYS: string[];
+/** CornerRadiusState is what the tool needs from the editor state. */
+export interface CornerRadiusState {
+    /** Radius in pixels of the final image; 0 means square corners. */
+    radius: number;
+    isEllipse: boolean;
+    /** Width the image is resized to, or 0 when it keeps its size. */
+    resizeWidth: number;
+    /** The crop tool is open: the canvas shows the whole image, not the crop box. */
+    isCropping: boolean;
+}
+/** PathContext is the part of a canvas context a corner wedge is traced with. */
+export interface PathContext {
+    moveTo(x: number, y: number): void;
+    lineTo(x: number, y: number): void;
+    arcTo(x1: number, y1: number, x2: number, y2: number, radius: number): void;
+    closePath(): void;
+}
+/** maxCornerRadius is half of the shorter side: a square turns into a circle, a rectangle into a capsule. */
+export declare function maxCornerRadius(width: number, height: number): number;
+/** clampCornerRadius turns any input into a whole radius between 0 and the maximum for the image. */
+export declare function clampCornerRadius(value: unknown, width: number, height: number): number;
+/** toLayerRadius converts a radius from final image pixels to the units of the layer showing the crop. */
+export declare function toLayerRadius(radius: number, layerWidth: number, finalWidth: number): number;
+/**
+ * traceCornerWedges adds to the path the four corner regions that lie between a rectangle and the
+ * same rectangle with rounded corners. Returns false when there is nothing to trace.
+ */
+export declare function traceCornerWedges(ctx: PathContext, x: number, y: number, width: number, height: number, radius: number): boolean;
+/** readCornerRadiusState picks the tool's inputs out of the editor state; reset leaves `extra` undefined. */
+export declare function readCornerRadiusState(editorState: unknown): CornerRadiusState;
+/** insertToolAfter returns the tab's tool list with the tool right after its anchor, or at the end. */
+export declare function insertToolAfter(tools: readonly string[], anchor: string, tool: string): string[];

package/components/FilerobotEditor/cornerRadius/cornerRadiusOutput.d.ts

@@ -0,0 +1,18 @@
+/** CornerRadiusOutput says how an edited image is saved once its corners may be rounded. */
+export interface CornerRadiusOutput {
+    /** Save as PNG: rounded corners are transparent, and only PNG keeps that through compression. */
+    forcePng: boolean;
+    /** The stored file may be overwritten: only when the format stays the same. */
+    canOverwrite: boolean;
+}
+/**
+ * resolveCornerRadiusOutput picks the format and whether overwriting is allowed. Overwriting keeps
+ * the file's address and name; with a PNG behind a `.jpg` address storages and mail clients may
+ * show the image wrongly, so a format change is saved as a copy.
+ */
+export declare function resolveCornerRadiusOutput(options: {
+    sourceMimeType: string;
+    isRounded: boolean;
+}): CornerRadiusOutput;
+/** toPngFileName swaps the file extension for `.png`, or adds it. */
+export declare function toPngFileName(name: string): string;

package/components/FilerobotEditor/cornerRadius/imageEditorTools.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentType } from 'react';
+/** ImageEditorToolItem is an entry of the editor's tool registry. */
+export interface ImageEditorToolItem {
+    id: string;
+    Item: ComponentType<any>;
+    ItemOptions?: ComponentType<any>;
+}
+/** IMAGE_EDITOR_TOOLS is the editor's tool registry plus the corner radius tool, for the `tools` config. */
+export declare const IMAGE_EDITOR_TOOLS: Record<string, ImageEditorToolItem>;
+/** IMAGE_EDITOR_TABS_TOOLS lists tools per tab, corner radius right after crop; for the `tabsToolsIds` config. */
+export declare const IMAGE_EDITOR_TABS_TOOLS: Record<string, string[]>;

package/components/FilerobotEditor/cornerRadius/useCornerRadiusSync.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import { CORNER_RADIUS_TOOL_ID } from './cornerRadiusMath';
+import { IMAGE_EDITOR_TABS_TOOLS, IMAGE_EDITOR_TOOLS } from './imageEditorTools';
+import type { CornerRadiusToolConfig } from './CornerRadiusTool';
+/** CornerRadiusEditorConfig is spread into the image editor config to enable the corner radius tool. */
+export interface CornerRadiusEditorConfig {
+    tools: typeof IMAGE_EDITOR_TOOLS;
+    tabsToolsIds: typeof IMAGE_EDITOR_TABS_TOOLS;
+    onModify: (state: unknown) => void;
+    [CORNER_RADIUS_TOOL_ID]: CornerRadiusToolConfig;
+}
+/** CornerRadiusSync is what an editor wrapper needs from the corner radius tool. */
+export interface CornerRadiusSync {
+    /** Corners will be cut on save: a radius above 0 and no ellipse crop. */
+    isRounded: boolean;
+    editorConfig: CornerRadiusEditorConfig;
+}
+/**
+ * useCornerRadiusSync keeps the canvas eraser in step with the tool state. The state arrives two ways:
+ * from the tool itself during a slider gesture, and from `onModify` on undo, redo, reset and changes
+ * made on other tabs.
+ */
+export declare function useCornerRadiusSync(containerRef: React.RefObject<HTMLElement | null>): CornerRadiusSync;

package/components/ImageIcons/iconSets.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Icon sets are fetched at runtime instead of being bundled.
+ *
+ * Importing `@iconify-json/*` as modules turns their JSON into string literals inside the bundle:
+ * lucide 581 kB and tabler 2.12 MB, 2.7 MB of data a bundler can neither split nor shake. Fetched
+ * as files they are cached by the browser, versioned on their own and cost nothing at build time.
+ *
+ * The tab that needs them is lazy, so the bytes reach the user at the same moment as before.
+ */
+import type { IconifyJSON } from '@iconify/types';
+export declare const ICON_SET_PREFIXES: readonly ['lucide', 'tabler'];
+export type IconSetPrefix = (typeof ICON_SET_PREFIXES)[number];
+/** Where the host publishes the sets. Matches the copy step of the build pipeline. */
+export declare const ICON_SETS_ASSETS_PATH = "static/media/icon-sets";
+export interface IconSetsSource {
+    /** Application base url, same one the image editor gets. */
+    baseUrl?: string;
+    /** Directory with the set files; defaults to `ICON_SETS_ASSETS_PATH`. */
+    path?: string;
+    /** Host loader of a set; when given it is the only source and nothing is fetched. */
+    load?: (prefix: IconSetPrefix) => Promise<IconifyJSON>;
+}
+/**
+ * Points the loader at the host assets. Changing the source drops what was already fetched:
+ * a different host means different files.
+ */
+export declare function configureIconSets(next: IconSetsSource): void;
+/** Loads one set once; repeated calls share the same request. */
+export declare function loadIconSet(prefix: IconSetPrefix): Promise<IconifyJSON | null>;
+/** Loads every set the stock search works with. Sets that failed to load are skipped. */
+export declare function loadIconSets(): Promise<{
+    prefix: IconSetPrefix;
+    json: IconifyJSON;
+}[]>;
+/** Already loaded set, or `null`. For code paths that must not await. */
+export declare function getLoadedIconSet(prefix: string): IconifyJSON | null;
+/** Test helper: the caches are module-level, so cases would leak into one another. */
+export declare function resetIconSets(): void;

package/components/ImageIcons/iconSets.test.d.ts

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

package/components/ImageIcons/iconStockSearch.d.ts

@@ -1,6 +1,8 @@
 import type { StreamlineSearchItem } from '../../types';
+/** Test helper: индекс модульный, иначе случаи протекали бы друг в друга. */
+export declare function resetStockIconIndex(): void;
 /** Стабильный id вида `prefix:icon-name` для кэша и `StreamlineSearchItem.hash`. */
-export declare function listMatchingStockIconIds(query: string): string[];
+export declare function listMatchingStockIconIds(query: string): Promise<string[]>;
 /** Сохраняет порядок `primary`, в конец добавляет id из `secondary`, которых ещё не было. */
 export declare function mergeStockIconIdsOrdered(primary: string[], secondary: string[]): string[];
 export declare function stockIconIdToItem(fullId: string): StreamlineSearchItem;

package/components/ImageIcons/packagedIconSets.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Icon set files shipped inside this package: the build puts them into `dist/assets/icon-sets`,
+ * next to the chunk that loads them.
+ *
+ * The URLs are literal `new URL(..., import.meta.url)` on purpose: the host bundler (webpack 5,
+ * Vite, Parcel) recognises the pattern and emits the files itself, so the host does not have to
+ * copy them by hand. Served unbundled, the URL points into the package directory directly.
+ */
+export declare function packagedIconSetUrl(prefix: string): string | undefined;

package/core.d.ts

@@ -19,3 +19,4 @@ export { PathAwareStorageAdapter } from './adapters/PathAwareStorageAdapter';
 export { fetchRemoteImageBlobByUrl, type FetchRemoteImageBlobOptions, type RemoteFileFetchHandlers, type RemoteFileFetchIntent, } from './utils/remoteFileFetchPipeline';
 export type { Folder, File, PathItem, FileManagerOptions, FileManagerErrorCode, IFileManagerApiError, SortOptionType, FileManagerItemMeta, } from './types';
 export type { StorageProvider, StorageProviderController, FileSystemItem, FileSystemItemUpdate, GetFileDataOptions, BatchResult as StorageBatchResult, OperationResult as StorageOperationResult, FileManagerApiErrorInfo, StorageApiPaginationResponse, StorageSortState, StorageUploadFileItemInput, StorageUploadFilesRequest, MayBePromise, } from './types/storage';
+export { PNG_COMPRESSION_COLORS, PNG_INITIAL_QUALITY, isAnimatedPng, isAnimatedPngFile, keepSmallerPng, } from './utils/pngCompression';