@uploadcare/file-uploader 1.28.0 → 1.29.0-alpha.0

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import _default from './locales/file-uploader/en.js';
 import * as lit_html from 'lit-html';
 import * as lit_html_directives_ref_js from 'lit-html/directives/ref.js';
 import * as _uploadcare_upload_client from '@uploadcare/upload-client';
-import { UploadcareFile, Metadata, FileFromOptions, UploadError, NetworkError, UploadcareGroup, Queue } from '@uploadcare/upload-client';
+import { FileFromOptions, Metadata, UploadcareFile, UploadError, NetworkError, UploadcareGroup, Queue } from '@uploadcare/upload-client';
 export { Metadata, NetworkError, UploadError, UploadcareError, UploadcareFile, UploadcareGroup } from '@uploadcare/upload-client';
 import { Ref } from 'lit/directives/ref.js';
 import { TelemetryRequest } from '@uploadcare/quality-insights';
@@ -90,8 +90,72 @@ declare class A11y implements ISharedInstance {
 declare class LocaleManager extends SharedInstance {
     private _localeName;
     constructor(sharedInstancesBag: SharedInstancesBag);
+    private _applyOverrides;
+    private _applyPluginLocales;
 }
 
+/**
+ * Custom configuration options registration system for plugins
+ */
+type CustomConfigDefinition<T = unknown> = {
+    /**
+     * Config option name (will be used as property and optionally as attribute)
+     */
+    name: string;
+    /**
+     * Default value for the config option
+     */
+    defaultValue: T;
+    /**
+     * Whether this config can be set via HTML attribute
+     * @default true
+     */
+    attribute?: boolean;
+    /**
+     * Convert attribute string to config value
+     * Only used if attribute is true
+     */
+    fromAttribute?: (value: string | null) => T;
+    /**
+     * Convert config value to attribute string
+     * Only used if attribute is true
+     */
+    toAttribute?: (value: T) => string | null;
+    /**
+     * Normalize/validate the config value
+     */
+    normalize?: (value: unknown) => T;
+};
+/**
+ * Registry for custom config options defined by plugins
+ * This is managed by the PluginManager as a shared instance property
+ */
+declare class CustomConfigRegistry {
+    private _definitions;
+    register<T = unknown>(pluginId: string, definition: CustomConfigDefinition<T>): void;
+    unregister(name: string): void;
+    unregisterByPlugin(pluginId: string): void;
+    get(name: string): CustomConfigDefinition<any> | undefined;
+    getAll(): Map<string, CustomConfigDefinition<any>>;
+}
+/**
+ * Interface for TypeScript module augmentation
+ * Plugins should extend this interface to add their custom config types
+ *
+ * @example
+ * ```typescript
+ * declare module '@uploadcare/file-uploader' {
+ *   interface CustomConfig {
+ *     'my-custom-option': string;
+ *   }
+ * }
+ * ```
+ */
+interface CustomConfig {
+}
+
+declare function buildOutputCollectionState<TCollectionStatus extends OutputCollectionStatus, TGroupFlag extends GroupFlag = 'maybe-has-group'>(bag: SharedInstancesBag): OutputCollectionState<TCollectionStatus, TGroupFlag>;
+
 declare class TypedData<T extends Record<string, unknown>> {
     private _ctxId;
     private _data;
@@ -104,6 +168,41 @@ declare class TypedData<T extends Record<string, unknown>> {
     destroy(): void;
 }
 
+type FuncFileValidator = (outputEntry: OutputFileEntry, api: UploaderPublicApi, options?: {
+    signal?: AbortSignal;
+}) => undefined | OutputErrorFile | Promise<undefined | OutputErrorFile>;
+type FileValidatorDescriptor = {
+    runOn: 'add' | 'upload' | 'change';
+    validator: FuncFileValidator;
+};
+type FileValidator = FileValidatorDescriptor | FuncFileValidator;
+type FuncCollectionValidator = (collection: ReturnType<typeof buildOutputCollectionState<OutputCollectionStatus>>, api: UploaderPublicApi) => undefined | OutputErrorCollection;
+declare class ValidationManager extends SharedInstance {
+    private get _uploadCollection();
+    private _commonFileValidators;
+    private _commonCollectionValidators;
+    private _queue;
+    private _runQueueDebounced;
+    private _isDestroyed;
+    private _entryValidationState;
+    constructor(sharedInstancesBag: SharedInstancesBag);
+    runFileValidators(runOn: FileValidatorDescriptor['runOn'], entryIds?: Uid[]): void;
+    runCollectionValidators(): void;
+    cleanupValidationForEntry(entry: TypedData<UploadEntryData>): void;
+    private _runFileValidatorsForEntry;
+    private _addCustomTypeToValidationError;
+    private _getEntryValidationState;
+    private _getValidatorDescriptors;
+    private _getValidatorDescriptorsForEntry;
+    destroy(): void;
+}
+
+declare class SecureUploadsManager extends SharedInstance {
+    private _secureToken;
+    getSecureToken(): Promise<SecureUploadsSignatureAndExpire | null>;
+    destroy(): void;
+}
+
 type ChangeMap<T extends Record<string, unknown>> = Record<keyof T, Set<Uid>>;
 type TypedCollectionPropertyObserver<T extends Record<string, unknown>> = (changeMap: ChangeMap<T>) => void;
 type TypedCollectionObserverHandler<T extends Record<string, unknown>> = (list: Uid[], added: Set<TypedData<T>>, removed: Set<TypedData<T>>) => void;
@@ -155,157 +254,6 @@ declare const CameraSourceTypes: Readonly<{
 }>;
 type ModeCameraType = (typeof CameraSourceTypes)[keyof typeof CameraSourceTypes];
 
-declare function buildOutputCollectionState<TCollectionStatus extends OutputCollectionStatus, TGroupFlag extends GroupFlag = 'maybe-has-group'>(bag: SharedInstancesBag): OutputCollectionState<TCollectionStatus, TGroupFlag>;
-
-interface UploadEntryData extends Record<string, unknown> {
-    file: File | null;
-    externalUrl: string | null;
-    fileName: string | null;
-    fileSize: number | null;
-    lastModified: number;
-    uploadProgress: number;
-    uuid: string | null;
-    isImage: boolean;
-    mimeType: string | null;
-    ctxName: string | null;
-    cdnUrl: string | null;
-    cdnUrlModifiers: string | null;
-    fileInfo: UploadcareFile | null;
-    isUploading: boolean;
-    abortController: AbortController | null;
-    thumbUrl: string | null;
-    silent: boolean;
-    source: string | null;
-    fullPath: string | null;
-    metadata: Metadata | null;
-    errors: OutputErrorFile[];
-    uploadError: Error | null;
-    isRemoved: boolean;
-    isQueuedForUploading: boolean;
-    isValidationPending: boolean;
-    isQueuedForValidation: boolean;
-}
-type UploadEntryTypedData = TypedData<UploadEntryData>;
-type UploadEntryKeys = keyof UploadEntryData;
-
-type ApiAddFileCommonOptions = {
-    silent?: boolean;
-    fileName?: string;
-    source?: string;
-};
-declare class UploaderPublicApi extends SharedInstance {
-    private _l10n;
-    get _uploadCollection(): TypedCollection<UploadEntryData>;
-    get cfg(): Readonly<ConfigType>;
-    get l10n(): (str: string, variables?: Record<string, string | number>) => string;
-    /**
-     * TODO: Probably we should not allow user to override `source` property
-     */
-    addFileFromUrl: (url: string, { silent, fileName, source }?: ApiAddFileCommonOptions) => OutputFileEntry<"idle">;
-    addFileFromUuid: (uuid: string, { silent, fileName, source }?: ApiAddFileCommonOptions) => OutputFileEntry<"idle">;
-    addFileFromCdnUrl: (cdnUrl: string, { silent, fileName, source }?: ApiAddFileCommonOptions) => OutputFileEntry<"idle">;
-    addFileFromObject: (file: File, { silent, fileName, source, fullPath, }?: ApiAddFileCommonOptions & {
-        fullPath?: string;
-    }) => OutputFileEntry<"idle">;
-    removeFileByInternalId: (internalId: string) => void;
-    removeAllFiles(): void;
-    uploadAll: () => void;
-    openSystemDialog: (options?: {
-        captureCamera?: boolean;
-        modeCamera?: ModeCameraType;
-    }) => void;
-    getOutputItem<TStatus extends OutputFileStatus>(entryId: string): OutputFileEntry<TStatus>;
-    getOutputCollectionState<TStatus extends OutputCollectionStatus>(): ReturnType<typeof buildOutputCollectionState<TStatus>>;
-    initFlow: (force?: boolean) => void;
-    doneFlow: () => void;
-    setCurrentActivity: <T extends RegisteredActivityType>(activityType: T, ...params: T extends keyof ActivityParamsMap ? [ActivityParamsMap[T]] : T extends RegisteredActivityType ? [undefined?] : [never]) => void;
-    getCurrentActivity: () => ActivityType;
-    setModalState: (opened: boolean) => void;
-    private get _sourceList();
-}
-
-declare const ExternalUploadSource: Readonly<{
-    readonly FACEBOOK: "facebook";
-    readonly DROPBOX: "dropbox";
-    readonly DROPBOX_CHOOSER: "dropboxchooser";
-    readonly GDRIVE: "gdrive";
-    readonly GPHOTOS: "gphotos";
-    readonly FLICKR: "flickr";
-    readonly VK: "vk";
-    readonly EVERNOTE: "evernote";
-    readonly BOX: "box";
-    readonly ONEDRIVE: "onedrive";
-    readonly HUDDLE: "huddle";
-}>;
-declare const UploadSource: Readonly<{
-    readonly FACEBOOK: "facebook";
-    readonly DROPBOX: "dropbox";
-    readonly DROPBOX_CHOOSER: "dropboxchooser";
-    readonly GDRIVE: "gdrive";
-    readonly GPHOTOS: "gphotos";
-    readonly FLICKR: "flickr";
-    readonly VK: "vk";
-    readonly EVERNOTE: "evernote";
-    readonly BOX: "box";
-    readonly ONEDRIVE: "onedrive";
-    readonly HUDDLE: "huddle";
-    readonly MOBILE_VIDEO_CAMERA: "mobile-video-camera";
-    readonly MOBILE_PHOTO_CAMERA: "mobile-photo-camera";
-    readonly LOCAL: "local";
-    readonly DROP_AREA: "drop-area";
-    readonly CAMERA: "camera";
-    readonly EXTERNAL: "external";
-    readonly API: "js-api";
-    readonly URL: "url";
-    readonly DRAW: "draw";
-}>;
-type SourceTypes = (typeof UploadSource)[keyof typeof UploadSource];
-
-declare class LitUploaderBlock extends LitActivityBlock {
-    static extSrcList: Readonly<typeof ExternalUploadSource>;
-    static sourceTypes: Readonly<typeof UploadSource>;
-    protected couldBeCtxOwner: boolean;
-    private _isCtxOwner;
-    private _unobserveCollection?;
-    private _unobserveCollectionProperties?;
-    init$: {
-        '*commonProgress': number;
-        '*uploadList': never[];
-        '*uploadQueue': _uploadcare_upload_client.Queue;
-        '*collectionErrors': OutputErrorCollection[];
-        '*collectionState': OutputCollectionState | null;
-        '*groupInfo': _uploadcare_upload_client.UploadcareGroup | null;
-        '*uploadTrigger': Set<string>;
-        '*currentActivity': null;
-        '*currentActivityParams': {};
-        '*history': never[];
-        '*historyBack': null;
-        '*closeModal': () => void;
-    };
-    private get _hasCtxOwner();
-    initCallback(): void;
-    getAPI(): UploaderPublicApi;
-    get validationManager(): ValidationManager;
-    get api(): UploaderPublicApi;
-    get uploadCollection(): TypedCollection<UploadEntryData>;
-    get secureUploadsManager(): SecureUploadsManager;
-    disconnectedCallback(): void;
-    connectedCallback(): void;
-    private _initCtxOwner;
-    private _observeUploadCollection;
-    private _unobserveUploadCollection;
-    private _createGroup;
-    private _flushOutputItems;
-    private _handleCollectionUpdate;
-    private _handleCollectionPropertiesUpdate;
-    private _flushCommonUploadProgress;
-    private _openCloudImageEditor;
-    private _setInitialCrop;
-    protected getMetadataFor(entryId: string): Promise<_uploadcare_upload_client.Metadata | undefined>;
-    protected getUploadClientOptions(): Promise<FileFromOptions>;
-    getOutputData(): OutputFileEntry[];
-}
-
 /**
  * Mapping of loading resources per operation
  */
@@ -420,11 +368,14 @@ declare global {
 declare class Icon extends LitBlock {
     name: string;
     private _resolvedHref;
+    private _pluginSvg;
     private _iconHrefResolver;
+    private _unsubscribePlugins?;
     initCallback(): void;
     protected willUpdate(changedProperties: PropertyValues<this>): void;
     private _updateResolvedHref;
     render(): lit_html.TemplateResult<1>;
+    disconnectedCallback(): void;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -955,6 +906,7 @@ declare class CloudImageEditorBlock extends LitBlock {
     private _hasNetworkProblems;
     private _isInitialized;
     private _pendingInitUpdate;
+    private _pendingSizeWait;
     private readonly _debouncedShowLoader;
     private readonly _imgRef;
     private readonly _cropperRef;
@@ -1004,12 +956,11 @@ type ActivityParams$1 = {
     internalId: string;
 };
 declare class CloudImageEditorActivity extends LitUploaderBlock {
-    couldBeCtxOwner: boolean;
-    activityType: "cloud-image-edit";
     private _entry?;
     private _editorConfig;
     get activityParams(): ActivityParams$1;
     initCallback(): void;
+    disconnectedCallback(): void;
     private _handleApply;
     private _handleCancel;
     handleChange(event: CustomEvent<ChangeResult>): void;
@@ -1046,7 +997,6 @@ type ActivityParams = {
 };
 declare class ExternalSource extends LitUploaderBlock {
     couldBeCtxOwner: boolean;
-    activityType: "external";
     private _messageBridge?;
     private _iframeRef;
     private _latestSelectionSummary;
@@ -1090,22 +1040,26 @@ declare global {
 declare const ACTIVITY_TYPES: Readonly<{
     START_FROM: "start-from";
     CAMERA: "camera";
-    DRAW: "draw";
     UPLOAD_LIST: "upload-list";
     URL: "url";
     CLOUD_IMG_EDIT: "cloud-image-edit";
     EXTERNAL: "external";
 }>;
-type RegisteredActivityType = (typeof ACTIVITY_TYPES)[keyof typeof ACTIVITY_TYPES];
-type ActivityType = RegisteredActivityType | (string & {}) | null;
+type RegisteredActivityType = (typeof ACTIVITY_TYPES)[keyof typeof ACTIVITY_TYPES] | keyof CustomActivities;
+type ActivityType = RegisteredActivityType | null;
 
 declare const ACTIVE_PROP = "___ACTIVITY_IS_ACTIVE___";
+interface CustomActivities {
+}
 type ActivityParamsMap = {
     'cloud-image-edit': ActivityParams$1;
     external: ActivityParams;
+} & {
+    [Key in keyof CustomActivities]: CustomActivities[Key]['params'];
 };
 declare class LitActivityBlock extends LitBlock {
     protected historyTracked: boolean;
+    activityType: ActivityType;
     private [ACTIVE_PROP]?;
     init$: {
         '*currentActivity': null;
@@ -1119,12 +1073,11 @@ declare class LitActivityBlock extends LitBlock {
     private _activate;
     initCallback(): void;
     private _historyFlush;
-    private _isActivityRegistered;
+    protected _isActivityRegistered(): boolean;
     private static _activityCallbacks;
     static activities: Readonly<{
         START_FROM: 'start-from';
         CAMERA: 'camera';
-        DRAW: 'draw';
         UPLOAD_LIST: 'upload-list';
         URL: 'url';
         CLOUD_IMG_EDIT: 'cloud-image-edit';
@@ -1140,8 +1093,8 @@ declare class LitActivityBlock extends LitBlock {
     private _unregisterActivity;
     disconnectedCallback(): void;
     get activityParams(): ActivityParamsMap[keyof ActivityParamsMap];
-    get initActivity(): string | null;
-    get doneActivity(): string | null;
+    get initActivity(): RegisteredActivityType | null;
+    get doneActivity(): RegisteredActivityType | null;
     historyBack(): void;
 }
 
@@ -1203,7 +1156,9 @@ type EventPayload = {
 declare class EventEmitter extends SharedInstance {
     private _timeoutStore;
     private _targets;
+    private _listeners;
     bindTarget(target: LitBlock): () => void;
+    on<T extends EventKey>(type: T, handler: (payload: EventPayload[T]) => void): () => void;
     private _dispatch;
     emit<T extends EventKey, TDebounce extends boolean | number | undefined = undefined>(type: T, payload?: TDebounce extends false | undefined ? EventPayload[T] : () => EventPayload[T], options?: {
         debounce?: TDebounce;
@@ -1211,20 +1166,123 @@ declare class EventEmitter extends SharedInstance {
     destroy(): void;
 }
 
-type EventMap = {
-    [T in keyof EventPayload]: CustomEvent<EventPayload[T]>;
+type ApiAddFileCommonOptions = {
+    silent?: boolean;
+    fileName?: string;
+    source?: string;
 };
+declare class UploaderPublicApi extends SharedInstance {
+    private _l10n;
+    get _uploadCollection(): TypedCollection<UploadEntryData>;
+    get cfg(): Readonly<ConfigType>;
+    get l10n(): (str: string, variables?: Record<string, string | number>) => string;
+    /**
+     * TODO: Probably we should not allow user to override `source` property
+     */
+    addFileFromUrl: (url: string, { silent, fileName, source }?: ApiAddFileCommonOptions) => OutputFileEntry<"idle">;
+    addFileFromUuid: (uuid: string, { silent, fileName, source }?: ApiAddFileCommonOptions) => OutputFileEntry<"idle">;
+    addFileFromCdnUrl: (cdnUrl: string, { silent, fileName, source }?: ApiAddFileCommonOptions) => OutputFileEntry<"idle">;
+    addFileFromObject: (file: File, { silent, fileName, source, fullPath, }?: ApiAddFileCommonOptions & {
+        fullPath?: string;
+    }) => OutputFileEntry<"idle">;
+    removeFileByInternalId: (internalId: string) => void;
+    removeAllFiles(): void;
+    uploadAll: () => void;
+    openSystemDialog: (options?: {
+        captureCamera?: boolean;
+        modeCamera?: ModeCameraType;
+    }) => void;
+    getOutputItem<TStatus extends OutputFileStatus>(entryId: string): OutputFileEntry<TStatus>;
+    getOutputCollectionState<TStatus extends OutputCollectionStatus>(): ReturnType<typeof buildOutputCollectionState<TStatus>>;
+    initFlow: (force?: boolean) => void;
+    doneFlow: () => void;
+    private _pluginsReady;
+    setCurrentActivity: <T extends ActivityType>(activityType: T, ...params: T extends keyof ActivityParamsMap ? [ActivityParamsMap[T]] extends [never] ? [] : [ActivityParamsMap[T]] : []) => void;
+    on: <T extends EventKey>(type: T, handler: (payload: EventPayload[T]) => void) => (() => void);
+    getCurrentActivity: () => ActivityType;
+    historyBack: () => void;
+    setModalState: (opened: boolean) => void;
+    private get _sourceList();
+}
 
-type PasteScope = 'local' | 'global' | false;
-declare class ClipboardLayer extends SharedInstance {
-    private scopes;
-    private listener;
-    constructor(sharedInstancesBag: SharedInstancesBag);
-    private openUploadList;
-    private _listener;
-    private handlePaste;
-    registerBlock(scope: Node): () => void;
-    destroy(): void;
+declare const ExternalUploadSource: Readonly<{
+    readonly FACEBOOK: "facebook";
+    readonly DROPBOX: "dropbox";
+    readonly DROPBOX_CHOOSER: "dropboxchooser";
+    readonly GDRIVE: "gdrive";
+    readonly GPHOTOS: "gphotos";
+    readonly FLICKR: "flickr";
+    readonly VK: "vk";
+    readonly EVERNOTE: "evernote";
+    readonly BOX: "box";
+    readonly ONEDRIVE: "onedrive";
+    readonly HUDDLE: "huddle";
+}>;
+declare const UploadSource: Readonly<{
+    readonly FACEBOOK: "facebook";
+    readonly DROPBOX: "dropbox";
+    readonly DROPBOX_CHOOSER: "dropboxchooser";
+    readonly GDRIVE: "gdrive";
+    readonly GPHOTOS: "gphotos";
+    readonly FLICKR: "flickr";
+    readonly VK: "vk";
+    readonly EVERNOTE: "evernote";
+    readonly BOX: "box";
+    readonly ONEDRIVE: "onedrive";
+    readonly HUDDLE: "huddle";
+    readonly MOBILE_VIDEO_CAMERA: "mobile-video-camera";
+    readonly MOBILE_PHOTO_CAMERA: "mobile-photo-camera";
+    readonly LOCAL: "local";
+    readonly DROP_AREA: "drop-area";
+    readonly CAMERA: "camera";
+    readonly EXTERNAL: "external";
+    readonly API: "js-api";
+    readonly URL: "url";
+}>;
+type SourceTypes = (typeof UploadSource)[keyof typeof UploadSource];
+
+declare class LitUploaderBlock extends LitActivityBlock {
+    static extSrcList: Readonly<typeof ExternalUploadSource>;
+    static sourceTypes: Readonly<typeof UploadSource>;
+    protected couldBeCtxOwner: boolean;
+    private _isCtxOwner;
+    private _unobserveCollection?;
+    private _unobserveCollectionProperties?;
+    init$: {
+        '*commonProgress': number;
+        '*uploadList': never[];
+        '*uploadQueue': _uploadcare_upload_client.Queue;
+        '*collectionErrors': OutputErrorCollection[];
+        '*collectionState': OutputCollectionState | null;
+        '*groupInfo': _uploadcare_upload_client.UploadcareGroup | null;
+        '*uploadTrigger': Set<string>;
+        '*currentActivity': null;
+        '*currentActivityParams': {};
+        '*history': never[];
+        '*historyBack': null;
+        '*closeModal': () => void;
+    };
+    private get _hasCtxOwner();
+    initCallback(): void;
+    getAPI(): UploaderPublicApi;
+    get validationManager(): ValidationManager;
+    get api(): UploaderPublicApi;
+    get uploadCollection(): TypedCollection<UploadEntryData>;
+    get secureUploadsManager(): SecureUploadsManager;
+    disconnectedCallback(): void;
+    connectedCallback(): void;
+    private _initCtxOwner;
+    private _observeUploadCollection;
+    private _unobserveUploadCollection;
+    private _createGroup;
+    private _flushOutputItems;
+    private _handleCollectionUpdate;
+    private _handleCollectionPropertiesUpdate;
+    private _flushCommonUploadProgress;
+    private _setInitialCrop;
+    protected getMetadataFor(entryId: string): Promise<_uploadcare_upload_client.Metadata | undefined>;
+    protected getUploadClientOptions(): Promise<FileFromOptions>;
+    getOutputData(): OutputFileEntry[];
 }
 
 type SelectOption = {
@@ -1247,7 +1305,6 @@ declare global {
 type CameraMode = 'photo' | 'video';
 declare class CameraSource extends LitUploaderBlock {
     couldBeCtxOwner: boolean;
-    activityType: "camera";
     private _unsubPermissions;
     private _capturing;
     private _chunks;
@@ -1367,25 +1424,54 @@ declare global {
 /**
  * Config keys that can't be passed as attribute (because they are object or function)
  */
-declare const complexConfigKeys: readonly ["metadata", "localeDefinitionOverride", "secureUploadsSignatureResolver", "secureDeliveryProxyUrlResolver", "iconHrefResolver", "fileValidators", "collectionValidators", "mediaRecorderOptions"];
-/** Mapping of attribute names to state */
-declare const attrStateMapping: Record<string, string>;
+declare const complexConfigKeys: readonly ["metadata", "plugins", "localeDefinitionOverride", "secureUploadsSignatureResolver", "secureDeliveryProxyUrlResolver", "iconHrefResolver", "fileValidators", "collectionValidators", "mediaRecorderOptions"];
 declare class Config extends LitBlock {
     attributesMeta: Partial<ConfigPlainType> & {
         'ctx-name': string;
     };
     init$: LitBlock["init$"] & ConfigType;
     private _computationControllers;
+    private _pluginChangeUnsubscribe?;
+    private _mutationObserver?;
+    /**
+     * Mapping of attribute names to custom config keys for plugin-registered configs.
+     * Updated dynamically when plugins are registered or changed.
+     * Similar to builtinAttrKeyMapping but for custom configs.
+     */
+    private _customAttrKeyMapping;
+    /** Set of all custom config names registered by plugins */
+    private _customConfigKeys;
+    /**
+     * Map of custom config subscriptions (config name -> unsubscribe function)
+     * Used to track and clean up subscriptions when plugins change
+     */
+    private _customConfigSubscriptions;
+    /**
+     * Check if a key is a custom config (registered by plugins)
+     */
+    private _isCustomConfig;
+    /**
+     * Get the custom config definition for a key
+     */
+    private _getCustomConfigDefinition;
+    /**
+     * Get attribute names for a config key (kebab-case and lowercase)
+     */
+    private _getAttributeNames;
     private _flushValueToAttribute;
     private _flushValueToState;
     private _setValue;
     private _getValue;
     private _assertSameValueDifferentReference;
+    private _processCustomConfigs;
+    private _setupCustomConfigs;
+    private _setupMutationObserver;
     initCallback(): void;
-    attributeChangedCallback(name: keyof typeof attrStateMapping, oldVal: string, newVal: string): void;
+    attributeChangedCallback(name: string, oldVal: string, newVal: string): void;
+    disconnectedCallback(): void;
     static get observedAttributes(): string[];
 }
-interface Config extends ConfigType {
+interface Config extends ConfigType, CustomConfig {
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -1469,12 +1555,12 @@ declare class FileItem extends FileItemConfig {
     private _isFailed;
     private _isUploading;
     private _isFocused;
-    private _isEditable;
     private _showFileNames;
     private _ariaLabelStatusFile;
+    private _pluginFileActions;
     private _renderedOnce;
     private _observer?;
-    private _handleEdit;
+    private _unsubscribePlugins?;
     private _handleRemove;
     private _handleUploadClick;
     private _calculateState;
@@ -1486,6 +1572,8 @@ declare class FileItem extends FileItemConfig {
     private _handleEntryId;
     private _updateShowFileNames;
     protected willUpdate(changedProperties: PropertyValues<this>): void;
+    private _updatePluginFileActions;
+    private _handlePluginFileAction;
     initCallback(): void;
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -1794,6 +1882,10 @@ type ConfigType = {
      * Expiry threshold for secure uploads.
      */
     secureUploadsExpireThreshold: number;
+    /**
+     * Array of plugins to register with the uploader instance.
+     */
+    plugins: UploaderPlugin[];
     /**
      * Metadata for the file.
      */
@@ -2054,10 +2146,237 @@ type OutputCollectionState<TStatus extends OutputCollectionStatus = OutputCollec
     allEntries: OutputFileEntry[];
 });
 
-declare class SecureUploadsManager extends SharedInstance {
-    private _secureToken;
-    getSecureToken(): Promise<SecureUploadsSignatureAndExpire | null>;
+type PluginIconRegistration = {
+    name: string;
+    svg: string;
+};
+type PluginI18nRegistration = Record<string, Record<string, string>>;
+type PluginSourceRegistration = {
+    id: string;
+    label: string;
+    icon?: string;
+    /**
+     * @internal
+     *
+     * Optional expansion function. When present, SourceList calls this to determine
+     * which source IDs should actually be rendered in place of this source.
+     * Useful for sources that map to multiple device-specific variants (e.g. camera
+     * expanding to separate photo/video buttons on mobile).
+     * Return `[id]` (the source's own id) to render it as-is.
+     */
+    expand?: () => string[];
+    onSelect: () => Promise<void> | void;
+};
+type PluginRenderDispose = () => void;
+type PluginRender = (el: HTMLElement, activityParams: Record<string, unknown>) => PluginRenderDispose | undefined;
+type PluginActivityRegistration = {
+    id: string;
+    render: PluginRender;
+};
+type PluginFileActionRegistration = {
+    /** Unique action identifier. */
+    id: string;
+    /** Icon name to display in the action button. */
+    icon: string;
+    /** Label shown next to the icon in the action button. Accepts a plain string or an i18n key registered via `registerI18n`. */
+    label: string;
+    /** Return `true` to show the action button for the given file entry. */
+    shouldRender: (fileEntry: OutputFileEntry) => boolean;
+    onClick: (fileEntry: OutputFileEntry) => void | Promise<void>;
+};
+type PluginFileHookResult = {
+    /** The (optionally transformed) file */
+    file: File | Blob;
+};
+type PluginFileHookContext = PluginFileHookResult & {
+    /**
+     * An AbortSignal that fires when the operation is cancelled (e.g. upload aborted or file removed).
+     * Hooks should respect this signal to avoid doing unnecessary work.
+     */
+    signal: AbortSignal;
+};
+type PluginFileHookRegistration = {
+    /**
+     * When the hook is called:
+     * - `'beforeUpload'`: called right before the file is uploaded.
+     * - `'onAdd'`: called after the file is added to the upload list.
+     *
+     * Return the (optionally transformed) file. After the hook runs, `mimeType`,
+     * `isImage`, `fileSize`, and `fileName` are all re-derived from the returned file.
+     */
+    type: 'beforeUpload' | 'onAdd';
+    handler: (context: PluginFileHookContext) => PluginFileHookResult | Promise<PluginFileHookResult>;
+    /**
+     * Maximum time in milliseconds to wait for the hook to complete before skipping it.
+     * @default 30000
+     */
+    timeout?: number;
+};
+type PluginRegistryApi = {
+    registerSource: (source: PluginSourceRegistration) => void;
+    registerActivity: (activity: PluginActivityRegistration) => void;
+    registerFileAction: (fileAction: PluginFileActionRegistration) => void;
+    registerFileHook: (hook: PluginFileHookRegistration) => void;
+    registerIcon: (icon: PluginIconRegistration) => void;
+    registerI18n: (i18n: PluginI18nRegistration) => void;
+    registerConfig: <T = unknown>(definition: CustomConfigDefinition<T>) => void;
+};
+/**
+ * API for managing plugin config subscriptions
+ */
+type PluginConfigApi = {
+    get: <TKey extends keyof (ConfigType & CustomConfig)>(configName: TKey) => (ConfigType & CustomConfig)[TKey];
+    subscribe: <TKey extends keyof (ConfigType & CustomConfig)>(configName: TKey, callback: (value: (ConfigType & CustomConfig)[TKey]) => void) => () => void;
+};
+/**
+ * API for managing plugin activity interactions
+ */
+type PluginActivityApi = {
+    /**
+     * Get the current activity parameters.
+     *
+     * @returns The current activity parameters object
+     *
+     * @example
+     * ```typescript
+     * const params = pluginApi.activity.getParams();
+     * console.log('Current params:', params);
+     * ```
+     */
+    getParams: () => Record<string, unknown>;
+    /**
+     * Subscribe to changes in activity parameters.
+     * The callback will be called immediately with the current params,
+     * and then whenever the params change.
+     *
+     * Subscriptions are automatically cleaned up when the plugin is disposed.
+     *
+     * @param callback - Function to call with the new params
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * pluginApi.activity.subscribeToParams((params) => {
+     *   console.log('Activity params changed:', params);
+     * });
+     * // Cleanup happens automatically on plugin disposal
+     * ```
+     */
+    subscribeToParams: (callback: (params: Record<string, unknown>) => void) => () => void;
+};
+type PluginFileEntryUpdate = {
+    file?: File | Blob;
+    cdnUrl?: string | null;
+    cdnUrlModifiers?: string | null;
+    mimeType?: string | null;
+};
+type PluginFilesApi = {
+    /**
+     * Update mutable properties of a file entry by its internalId.
+     * `fileSize` is recalculated automatically when `file` is provided.
+     */
+    update: (internalId: string, changes: PluginFileEntryUpdate) => void;
+};
+type PluginApi = {
+    registry: PluginRegistryApi;
+    config: PluginConfigApi;
+    activity: PluginActivityApi;
+    files: PluginFilesApi;
+};
+type PluginUploaderApi = UploaderPublicApi;
+type PluginSetupResult = (() => void) | void | Promise<(() => void) | void>;
+type PluginSetupParams = {
+    pluginApi: PluginApi;
+    uploaderApi: PluginUploaderApi;
+};
+type UploaderPlugin = {
+    id: string;
+    setup: (params: PluginSetupParams) => PluginSetupResult;
+};
+type Owned<T> = T & {
+    pluginId: string;
+};
+type PluginRegistrySnapshot = {
+    sources: Owned<PluginSourceRegistration>[];
+    activities: Owned<PluginActivityRegistration>[];
+    fileActions: Owned<PluginFileActionRegistration>[];
+    fileHooks: Owned<PluginFileHookRegistration>[];
+    icons: Owned<PluginIconRegistration>[];
+    i18n: Owned<PluginI18nRegistration>[];
+};
+
+type EventMap = {
+    [T in keyof EventPayload]: CustomEvent<EventPayload[T]>;
+};
+
+interface UploadEntryData extends Record<string, unknown> {
+    file: File | null;
+    externalUrl: string | null;
+    fileName: string | null;
+    fileSize: number | null;
+    lastModified: number;
+    uploadProgress: number;
+    uuid: string | null;
+    isImage: boolean;
+    mimeType: string | null;
+    ctxName: string | null;
+    cdnUrl: string | null;
+    cdnUrlModifiers: string | null;
+    fileInfo: UploadcareFile | null;
+    isUploading: boolean;
+    abortController: AbortController | null;
+    thumbUrl: string | null;
+    silent: boolean;
+    source: string | null;
+    fullPath: string | null;
+    metadata: Metadata | null;
+    errors: OutputErrorFile[];
+    uploadError: Error | null;
+    isRemoved: boolean;
+    isQueuedForUploading: boolean;
+    isValidationPending: boolean;
+    isQueuedForValidation: boolean;
+}
+type UploadEntryTypedData = TypedData<UploadEntryData>;
+type UploadEntryKeys = keyof UploadEntryData;
+
+declare class PluginRegistry {
+    private _sources;
+    private _activities;
+    private _fileActions;
+    private _fileHooks;
+    private _icons;
+    private _i18n;
+    readonly config: CustomConfigRegistry;
+    private _own;
+    addSource(pluginId: string, item: PluginSourceRegistration): void;
+    addActivity(pluginId: string, item: PluginActivityRegistration): void;
+    addFileAction(pluginId: string, item: PluginFileActionRegistration): void;
+    addFileHook(pluginId: string, item: PluginFileHookRegistration): void;
+    addIcon(pluginId: string, item: PluginIconRegistration): void;
+    addI18n(pluginId: string, item: PluginI18nRegistration): void;
+    addConfig<T>(pluginId: string, definition: CustomConfigDefinition<T>): void;
+    purge(pluginId: string): void;
+    snapshot(): PluginRegistrySnapshot;
+}
+
+declare class PluginManager extends SharedInstance {
+    private _plugins;
+    private _subscribers;
+    private _pluginsUpdate;
+    private _lazyPluginLoader;
+    readonly registry: PluginRegistry;
+    get configRegistry(): CustomConfigRegistry;
+    constructor(sharedInstancesBag: SharedInstancesBag);
+    pluginsReady(): Promise<void>;
+    onPluginsChange(callback: Unsubscriber): Unsubscriber;
+    private _syncPlugins;
+    private _registerPlugin;
+    private _unregisterPlugin;
+    snapshot(): PluginRegistrySnapshot;
+    runOnAddHooks(entry: UploadEntryTypedData): Promise<void>;
     destroy(): void;
+    private _notifySubscribers;
 }
 
 type CommonEventType = InternalEventKey | EventKey;
@@ -2098,14 +2417,87 @@ declare class TelemetryManager extends SharedInstance {
     private get _location();
 }
 
+interface ISharedInstance {
+    destroy?(): void;
+}
+declare class SharedInstance {
+    protected _ctx: PubSub<SharedState>;
+    protected _sharedInstancesBag: SharedInstancesBag;
+    private _subscriptions;
+    private _cfgProxy;
+    protected _debugPrint: (...args: unknown[]) => void;
+    constructor(sharedInstancesBag: SharedInstancesBag);
+    protected addSub(unsub: () => void): void;
+    protected get _cfg(): Readonly<ConfigType>;
+    destroy(): void;
+}
+declare const instanceKeyMap: {
+    modalManager: "*modalManager";
+    pluginManager: "*pluginManager";
+    telemetryManager: "*telemetryManager";
+    localeManager: "*localeManager";
+    a11y: "*a11y";
+    clipboard: "*clipboard";
+    blocksRegistry: "*blocksRegistry";
+    eventEmitter: "*eventEmitter";
+    uploadCollection: "*uploadCollection";
+    secureUploadsManager: "*secureUploadsManager";
+    api: "*publicApi";
+    validationManager: "*validationManager";
+};
+type InstanceTypeMap = {
+    [key in keyof typeof instanceKeyMap]: SharedState[(typeof instanceKeyMap)[key]];
+};
+type InstanceName = keyof typeof instanceKeyMap;
+type SharedInstancesState = Pick<SharedState, (typeof instanceKeyMap)[keyof typeof instanceKeyMap]>;
+type SharedInstancesBag = ReturnType<typeof createSharedInstancesBag>;
+declare const createSharedInstancesBag: (getCtx: () => PubSub<SharedState>) => {
+    readonly ctx: PubSub<SharedState>;
+    readonly modalManager: ModalManager | null;
+    readonly pluginManager: PluginManager;
+    readonly telemetryManager: TelemetryManager;
+    readonly localeManager: LocaleManager;
+    readonly a11y: A11y;
+    readonly blocksRegistry: Set<LitBlock>;
+    readonly eventEmitter: EventEmitter;
+    readonly uploadCollection: TypedCollection<UploadEntryData>;
+    readonly secureUploadsManager: SecureUploadsManager;
+    readonly api: UploaderPublicApi;
+    readonly validationManager: ValidationManager;
+    when<TName extends InstanceName>(name: TName, callback: (instance: NonNullable<InstanceTypeMap[TName]>) => void): () => void;
+    wait<TName extends InstanceName>(name: TName): Promise<NonNullable<InstanceTypeMap[TName]>>;
+};
+
+type PasteScope = 'local' | 'global' | false;
+declare class ClipboardLayer extends SharedInstance {
+    private scopes;
+    private listener;
+    constructor(sharedInstancesBag: SharedInstancesBag);
+    private openUploadList;
+    private _listener;
+    private handlePaste;
+    registerBlock(scope: Node): () => void;
+    destroy(): void;
+}
+
+type ConfigGetter = <K extends keyof ConfigType>(key: K) => ConfigType[K];
+type LazyPluginEntry = {
+    configDeps: readonly (keyof ConfigType)[];
+    isEnabled: (get: ConfigGetter) => boolean;
+    load: () => UploaderPlugin | undefined | Promise<UploaderPlugin | undefined>;
+};
+
 type SharedConfigState = {
     [K in keyof ConfigType as `*cfg/${K}`]: ConfigType[K];
 };
+type SharedCustomConfigState = {
+    [K in keyof CustomConfig as `*cfg/${K}`]: CustomConfig[K];
+};
 type BlocksRegistry = Set<LitBlock>;
 type ActivityBlockCtxState = {
-    '*currentActivity': string | null;
+    '*currentActivity': RegisteredActivityType | null;
     '*currentActivityParams': Record<string, unknown>;
-    '*history': (string | null)[];
+    '*history': (RegisteredActivityType | null)[];
     '*historyBack': (() => void) | null;
     '*closeModal': () => void;
 };
@@ -2122,6 +2514,7 @@ type UploaderBlockCtxState = ActivityBlockCtxState & {
 };
 type SolutionBlockCtxState = UploaderBlockCtxState & {
     '*solution': string | null;
+    '*lazyPlugins': LazyPluginEntry[] | null;
 };
 type CloudImageEditorState = {
     '*originalUrl': string | null;
@@ -2172,7 +2565,9 @@ type EditorToolbarState = {
     '*currentOperation': string | null;
     '*operationTooltip': string | null;
 };
+type SharedContextInstances = Map<string, ISharedInstance>;
 type DynamicBlockState = {
+    '*sharedContextInstances': SharedContextInstances;
     '*blocksRegistry': BlocksRegistry;
     '*eventEmitter': EventEmitter;
     '*localeManager': LocaleManager;
@@ -2180,6 +2575,7 @@ type DynamicBlockState = {
     '*a11y': A11y;
     '*modalManager': ModalManager | null;
     '*clipboard': ClipboardLayer;
+    '*pluginManager': PluginManager;
 };
 type DynamicUploaderBlockState = {
     '*uploadCollection': TypedCollection<UploadEntryData>;
@@ -2190,66 +2586,7 @@ type DynamicUploaderBlockState = {
 type LocaleState = {
     [K in keyof LocaleDefinition as `*l10n/${K}`]: string;
 };
-type SharedState = SolutionBlockCtxState & SharedConfigState & CloudImageEditorState & EditorImageCropperState & EditorToolbarState & DynamicBlockState & DynamicUploaderBlockState & LocaleState;
-
-interface ISharedInstance {
-    destroy?(): void;
-}
-declare class SharedInstance {
-    protected _ctx: PubSub<SharedState>;
-    protected _sharedInstancesBag: SharedInstancesBag;
-    private _subscriptions;
-    private _cfgProxy;
-    protected _debugPrint: (...args: unknown[]) => void;
-    constructor(sharedInstancesBag: SharedInstancesBag);
-    protected addSub(unsub: () => void): void;
-    protected get _cfg(): Readonly<ConfigType>;
-    destroy(): void;
-}
-type SharedInstancesState = Pick<SharedState, '*blocksRegistry' | '*eventEmitter' | '*localeManager' | '*telemetryManager' | '*a11y' | '*clipboard' | '*modalManager' | '*uploadCollection' | '*publicApi' | '*validationManager' | '*secureUploadsManager'>;
-type SharedInstancesBag = ReturnType<typeof createSharedInstancesBag>;
-declare const createSharedInstancesBag: (getCtx: () => PubSub<SharedState>) => {
-    readonly ctx: PubSub<SharedState>;
-    readonly modalManager: ModalManager | null;
-    readonly telemetryManager: TelemetryManager;
-    readonly localeManager: LocaleManager;
-    readonly a11y: A11y;
-    readonly blocksRegistry: Set<LitBlock>;
-    readonly eventEmitter: EventEmitter;
-    readonly uploadCollection: TypedCollection<UploadEntryData>;
-    readonly secureUploadsManager: SecureUploadsManager;
-    readonly api: UploaderPublicApi;
-    readonly validationManager: ValidationManager;
-};
-
-type FuncFileValidator = (outputEntry: OutputFileEntry, api: UploaderPublicApi, options?: {
-    signal?: AbortSignal;
-}) => undefined | OutputErrorFile | Promise<undefined | OutputErrorFile>;
-type FileValidatorDescriptor = {
-    runOn: 'add' | 'upload' | 'change';
-    validator: FuncFileValidator;
-};
-type FileValidator = FileValidatorDescriptor | FuncFileValidator;
-type FuncCollectionValidator = (collection: ReturnType<typeof buildOutputCollectionState<OutputCollectionStatus>>, api: UploaderPublicApi) => undefined | OutputErrorCollection;
-declare class ValidationManager extends SharedInstance {
-    private get _uploadCollection();
-    private _commonFileValidators;
-    private _commonCollectionValidators;
-    private _queue;
-    private _runQueueDebounced;
-    private _isDestroyed;
-    private _entryValidationState;
-    constructor(sharedInstancesBag: SharedInstancesBag);
-    runFileValidators(runOn: FileValidatorDescriptor['runOn'], entryIds?: Uid[]): void;
-    runCollectionValidators(): void;
-    cleanupValidationForEntry(entry: TypedData<UploadEntryData>): void;
-    private _runFileValidatorsForEntry;
-    private _addCustomTypeToValidationError;
-    private _getEntryValidationState;
-    private _getValidatorDescriptors;
-    private _getValidatorDescriptorsForEntry;
-    destroy(): void;
-}
+type SharedState = SolutionBlockCtxState & SharedConfigState & SharedCustomConfigState & CloudImageEditorState & EditorImageCropperState & EditorToolbarState & DynamicBlockState & DynamicUploaderBlockState & LocaleState;
 
 declare const LitBlockBase: typeof LitElement & Constructor<{
     willYield: boolean;
@@ -2261,9 +2598,7 @@ declare const LitBlockBase: typeof LitElement & Constructor<{
 };
 declare class LitBlock extends LitBlockBase {
     private _cfgProxy;
-    protected _sharedContextInstances: Map<keyof SharedInstancesState, ISharedInstance>;
     static styleAttrs: string[];
-    activityType: ActivityType;
     init$: {};
     constructor();
     l10n: (str: string, variables?: Record<string, string | number>) => string;
@@ -2271,6 +2606,7 @@ declare class LitBlock extends LitBlockBase {
     protected _sharedInstancesBag: {
         readonly ctx: PubSub<SharedState>;
         readonly modalManager: ModalManager | null;
+        readonly pluginManager: PluginManager;
         readonly telemetryManager: TelemetryManager;
         readonly localeManager: LocaleManager;
         readonly a11y: A11y;
@@ -2280,6 +2616,34 @@ declare class LitBlock extends LitBlockBase {
         readonly secureUploadsManager: SecureUploadsManager;
         readonly api: UploaderPublicApi;
         readonly validationManager: ValidationManager;
+        when<TName extends "modalManager" | "pluginManager" | "telemetryManager" | "localeManager" | "a11y" | "clipboard" | "blocksRegistry" | "eventEmitter" | "uploadCollection" | "secureUploadsManager" | "api" | "validationManager">(name: TName, callback: (instance: NonNullable<{
+            modalManager: ModalManager | null;
+            pluginManager: PluginManager;
+            telemetryManager: TelemetryManager;
+            localeManager: LocaleManager;
+            a11y: A11y;
+            clipboard: ClipboardLayer;
+            blocksRegistry: BlocksRegistry;
+            eventEmitter: EventEmitter;
+            uploadCollection: TypedCollection<UploadEntryData>;
+            secureUploadsManager: SecureUploadsManager;
+            api: UploaderPublicApi;
+            validationManager: ValidationManager;
+        }[TName]>) => void): () => void;
+        wait<TName extends "modalManager" | "pluginManager" | "telemetryManager" | "localeManager" | "a11y" | "clipboard" | "blocksRegistry" | "eventEmitter" | "uploadCollection" | "secureUploadsManager" | "api" | "validationManager">(name: TName): Promise<NonNullable<{
+            modalManager: ModalManager | null;
+            pluginManager: PluginManager;
+            telemetryManager: TelemetryManager;
+            localeManager: LocaleManager;
+            a11y: A11y;
+            clipboard: ClipboardLayer;
+            blocksRegistry: BlocksRegistry;
+            eventEmitter: EventEmitter;
+            uploadCollection: TypedCollection<UploadEntryData>;
+            secureUploadsManager: SecureUploadsManager;
+            api: UploaderPublicApi;
+            validationManager: ValidationManager;
+        }[TName]>>;
     };
     emit(type: Parameters<EventEmitter['emit']>[0], payload?: Parameters<EventEmitter['emit']>[1], options?: Parameters<EventEmitter['emit']>[2]): void;
     hasBlockInCtx(callback: (block: LitBlock) => boolean): boolean;
@@ -2298,11 +2662,7 @@ declare class LitBlock extends LitBlockBase {
      * Called when the last block is removed from the context. Note that inheritors must run their callback before that.
      */
     private destroyCtxCallback;
-    /**
-     * Adds a shared context instance if it does not exist yet.
-     * @param key The shared state key.
-     * @param resolver The resolver function that creates the instance.
-     */
+    private _getSharedContextInstances;
     protected _addSharedContextInstance<TKey extends keyof SharedInstancesState>(key: TKey, resolver: (sharedInstancesBag: SharedInstancesBag) => NonNullable<SharedInstancesState[TKey]>): void;
     private _destroySharedContextInstances;
     protected _getSharedContextInstance<TKey extends keyof SharedState, TRequired extends boolean = true>(key: TKey, isRequired?: TRequired): TRequired extends true ? NonNullable<SharedState[TKey]> : SharedState[TKey];
@@ -2329,7 +2689,7 @@ declare class Modal extends LitBlock {
     private _handleDialogClose;
     private _handleDialogMouseDown;
     private _handleDialogMouseUp;
-    show(): void;
+    show(): Promise<void>;
     hide(): void;
     private _handleModalOpen;
     private _handleModalClose;
@@ -2401,8 +2761,10 @@ declare const toKebabCase: <T extends string>(str: T) => KebabCase<T>;
 
 declare class LitSolutionBlock extends LitBlock {
     static styleAttrs: string[];
+    static lazyPlugins: LazyPluginEntry[] | null;
     init$: {
         '*solution': string | null;
+        '*lazyPlugins': LazyPluginEntry[] | null;
         '*commonProgress': number;
         '*uploadList': never[];
         '*uploadQueue': _uploadcare_upload_client.Queue;
@@ -2534,18 +2896,20 @@ declare global {
     }
 }
 
+type SourceButtonConfig = {
+    id: string;
+    label: string;
+    icon?: string;
+    onClick: () => void | Promise<void>;
+};
 declare class SourceBtn extends LitUploaderBlock {
     couldBeCtxOwner: boolean;
-    private _registeredTypes;
-    type?: string;
+    source?: SourceButtonConfig;
     private _iconName;
     private _srcTypeKey;
-    private _initTypes;
-    initCallback(): void;
-    private _registerType;
-    activate(): void;
-    private _applyType;
     protected willUpdate(changedProperties: PropertyValues<this>): void;
+    private _applySource;
+    activate(): void;
     render(): lit_html.TemplateResult<1>;
 }
 declare global {
@@ -2554,9 +2918,10 @@ declare global {
     }
 }
 
-declare class SourceList extends LitBlock {
+declare class SourceList extends LitUploaderBlock {
     private _rawSourceList;
-    private _cameraModes;
+    private _unsubscribePlugins?;
+    private _sources;
     /**
      * CSS-only attribute
      */
@@ -2564,8 +2929,10 @@ declare class SourceList extends LitBlock {
     initCallback(): void;
     protected updated(changedProperties: PropertyValues<this>): void;
     private _updateSources;
-    private _sources;
+    private _expandSource;
+    private _makePluginSourceConfig;
     render(): lit_html.TemplateResult<1>;
+    disconnectedCallback(): void;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -2629,38 +2996,65 @@ declare global {
     }
 }
 
-declare class UrlSource extends LitUploaderBlock {
+declare class SimpleBtn extends LitUploaderBlock {
+    static styleAttrs: string[];
     couldBeCtxOwner: boolean;
-    activityType: ActivityType;
-    private _formState;
+    dropzone: boolean;
+    private _buttonTextKey;
+    private readonly _handleClick;
     initCallback(): void;
-    private _inputRef;
-    private _handleInput;
-    private _handleUpload;
     render(): lit_html.TemplateResult<1>;
 }
 declare global {
     interface HTMLElementTagNameMap {
-        'uc-url-source': UrlSource;
+        'uc-simple-btn': SimpleBtn;
     }
 }
 
-declare class SimpleBtn extends LitUploaderBlock {
-    static styleAttrs: string[];
-    couldBeCtxOwner: boolean;
-    dropzone: boolean;
-    private _buttonTextKey;
-    private readonly _handleClick;
+declare class PluginActivityHost extends LitActivityBlock {
+    registration: Owned<PluginActivityRegistration>;
+    private _dispose?;
+    private _containerRef;
+    initCallback(): void;
+    protected willUpdate(changedProperties: PropertyValues<this>): void;
+    private _ensureRegistered;
+    private _renderActivity;
+    private _disposeActivity;
+    disconnectedCallback(): void;
+    render(): lit_html.TemplateResult<1>;
+}
+declare class PluginActivityRenderer extends LitBlock {
+    mode: 'modal' | 'inline';
+    private _activities;
+    private _unsubscribePlugins?;
     initCallback(): void;
+    private _syncActivities;
+    disconnectedCallback(): void;
     render(): lit_html.TemplateResult<1>;
 }
 declare global {
     interface HTMLElementTagNameMap {
-        'uc-simple-btn': SimpleBtn;
+        'uc-plugin-activity-host': PluginActivityHost;
+        'uc-plugin-activity-renderer': PluginActivityRenderer;
+    }
+}
+
+declare class UrlSource extends LitUploaderBlock {
+    private _formState;
+    private _inputRef;
+    private _handleInput;
+    private _handleUpload;
+    firstUpdated(): void;
+    render(): lit_html.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'uc-url-source': UrlSource;
     }
 }
 
 declare class FileUploaderRegular extends LitSolutionBlock {
+    static lazyPlugins: LazyPluginEntry[];
     attributesMeta: {
         headless?: boolean;
         'ctx-name': string;
@@ -2678,6 +3072,7 @@ declare global {
 }
 
 declare class FileUploaderInline extends LitSolutionBlock {
+    static lazyPlugins: LazyPluginEntry[];
     attributesMeta: {
         'ctx-name': string;
     };
@@ -2698,6 +3093,7 @@ declare global {
 }
 
 declare class FileUploaderMinimal extends LitSolutionBlock {
+    static lazyPlugins: LazyPluginEntry[];
     attributesMeta: {
         'ctx-name': string;
     };
@@ -2721,4 +3117,4 @@ declare global {
     }
 }
 
-export { LitActivityBlock as ActivityBlock, ActivityHeader, type ApiAddFileCommonOptions, BaseComponent, LitBlock as Block, BtnUi, CameraSource, CloudImageEditor, CloudImageEditorActivity, CloudImageEditorBlock, type CollectionValidators, Config, type ConfigAttributesType, type ConfigComplexType, type ConfigPlainType, type ConfigType, Copyright, CropFrame, PubSub as Data, DropArea, EditorAspectRatioButtonControl, EditorCropButtonControl, EditorFilterControl, EditorFreeformButtonControl, EditorImageCropper, EditorImageFader, EditorOperationControl, EditorScroller, EditorSlider, EditorToolbar, type EventMap, type EventPayload, EventType, ExternalSource, ExternalUploadSource, FileItem, FileUploaderInline, FileUploaderMinimal, FileUploaderRegular, type FileValidator, type FileValidatorDescriptor, type FileValidators, FormInput, type FuncCollectionValidator, type FuncFileValidator, type GroupFlag, Icon, type IconHrefResolver, Img, type KebabCase$1 as KebabCase, type KebabCaseKeys, LineLoaderUi, type LocaleDefinitionOverride, type LowerCase, type LowerCaseKeys, type MetadataCallback, Modal, ModalEvents, type ModalId, type OutputCollectionErrorType, type OutputCollectionState, type OutputCollectionStatus, type OutputCustomErrorType, type OutputError, type OutputErrorCollection, type OutputErrorFile, type OutputErrorTypePayload, type OutputFileEntry, type OutputFileErrorPayload, type OutputFileErrorType, type OutputFileStatus, PresenceToggle, ProgressBar, ProgressBarCommon, type SecureDeliveryProxyUrlResolver, type SecureUploadsSignatureAndExpire, type SecureUploadsSignatureResolver, Select, SimpleBtn, SliderUi, LitSolutionBlock as SolutionBlock, SourceBtn, SourceList, type SourceTypes, Spinner, StartFrom, Thumb, UID, UploadCtxProvider, UploadList, UploadSource, LitUploaderBlock as UploaderBlock, UploaderPublicApi, UrlSource, defineComponents, defineLocale, toKebabCase };
+export { LitActivityBlock as ActivityBlock, ActivityHeader, type ActivityType, type ApiAddFileCommonOptions, BaseComponent, LitBlock as Block, BtnUi, CameraSource, CloudImageEditor, CloudImageEditorActivity, CloudImageEditorBlock, type CollectionValidators, Config, type ConfigAttributesType, type ConfigComplexType, type ConfigPlainType, type ConfigType, Copyright, CropFrame, type CustomActivities, type CustomConfig, type CustomConfigDefinition, PubSub as Data, DropArea, EditorAspectRatioButtonControl, EditorCropButtonControl, EditorFilterControl, EditorFreeformButtonControl, EditorImageCropper, EditorImageFader, EditorOperationControl, EditorScroller, EditorSlider, EditorToolbar, type EventMap, type EventPayload, EventType, ExternalSource, ExternalUploadSource, FileItem, FileUploaderInline, FileUploaderMinimal, FileUploaderRegular, type FileValidator, type FileValidatorDescriptor, type FileValidators, FormInput, type FuncCollectionValidator, type FuncFileValidator, type GroupFlag, Icon, type IconHrefResolver, Img, type KebabCase$1 as KebabCase, type KebabCaseKeys, LineLoaderUi, type LocaleDefinitionOverride, type LowerCase, type LowerCaseKeys, type MetadataCallback, Modal, ModalEvents, type ModalId, type OutputCollectionErrorType, type OutputCollectionState, type OutputCollectionStatus, type OutputCustomErrorType, type OutputError, type OutputErrorCollection, type OutputErrorFile, type OutputErrorTypePayload, type OutputFileEntry, type OutputFileErrorPayload, type OutputFileErrorType, type OutputFileStatus, type Owned, type PluginActivityApi, PluginActivityHost, type PluginActivityRegistration, PluginActivityRenderer, type PluginApi, type PluginConfigApi, type PluginFileActionRegistration, type PluginFileEntryUpdate, type PluginFileHookContext, type PluginFileHookRegistration, type PluginFileHookResult, type PluginFilesApi, type PluginI18nRegistration, type PluginIconRegistration, type PluginRegistryApi, type PluginRegistrySnapshot, type PluginRender, type PluginRenderDispose, type PluginSetupParams, type PluginSetupResult, type PluginSourceRegistration, type PluginUploaderApi, PresenceToggle, ProgressBar, ProgressBarCommon, type SecureDeliveryProxyUrlResolver, type SecureUploadsSignatureAndExpire, type SecureUploadsSignatureResolver, Select, SimpleBtn, SliderUi, LitSolutionBlock as SolutionBlock, SourceBtn, SourceList, type SourceTypes, Spinner, StartFrom, Thumb, UID, UploadCtxProvider, UploadList, UploadSource, LitUploaderBlock as UploaderBlock, type UploaderPlugin, UploaderPublicApi, UrlSource, defineComponents, defineLocale, toKebabCase };