@uploadcare/file-uploader 1.26.2 → 1.27.0-alpha.0

package/dist/index.d.ts

@@ -79,17 +79,77 @@ type LocaleDefinition = typeof _default;
 type LocaleDefinitionResolver = () => Promise<LocaleDefinition>;
 declare const defineLocale: (localeName: string, definitionOrResolver: LocaleDefinition | LocaleDefinitionResolver) => void;
 
-declare class A11y implements ISharedInstance {
-    private _destroyKeyUX;
-    private readonly _scopedWindow;
-    constructor();
-    registerBlock(scope: LitBlock): void;
-    destroy(): void;
-}
-
 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 class SecureUploadsManager extends SharedInstance {
+    private _secureToken;
+    getSecureToken(): Promise<SecureUploadsSignatureAndExpire | null>;
+    destroy(): void;
 }
 
 declare class TypedData<T extends Record<string, unknown>> {
@@ -218,7 +278,7 @@ declare class UploaderPublicApi extends SharedInstance {
     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;
+    setCurrentActivity: <T extends ActivityType>(activityType: T, ...params: T extends keyof ActivityParamsMap ? [ActivityParamsMap[T]] extends [never] ? [] : [ActivityParamsMap[T]] : []) => void;
     getCurrentActivity: () => ActivityType;
     setModalState: (opened: boolean) => void;
     private get _sourceList();
@@ -418,11 +478,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 {
@@ -1002,12 +1065,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;
@@ -1094,13 +1156,17 @@ declare const ACTIVITY_TYPES: Readonly<{
     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;
@@ -1117,7 +1183,7 @@ 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';
@@ -1138,8 +1204,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;
 }
 
@@ -1213,6 +1279,35 @@ type EventMap = {
     [T in keyof EventPayload]: CustomEvent<EventPayload[T]>;
 };
 
+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 SelectOption = {
     text: string;
     value: string;
@@ -1353,25 +1448,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 {
@@ -1455,12 +1579,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;
@@ -1472,6 +1596,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;
@@ -1776,6 +1902,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.
      */
@@ -2032,10 +2162,162 @@ type OutputCollectionState<TStatus extends OutputCollectionStatus = OutputCollec
     allEntries: OutputFileEntry[];
 });
 
-declare class SecureUploadsManager extends SharedInstance {
-    private _secureToken;
-    getSecureToken(): Promise<SecureUploadsSignatureAndExpire | null>;
+type PluginVersion = string;
+type PluginIconRegistration = {
+    name: string;
+    svg: string;
+};
+type PluginI18nRegistration = Record<string, Record<string, string>>;
+type PluginSourceRegistration = {
+    id: string;
+    label: string;
+    icon?: 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 = {
+    id: string;
+    icon: string;
+    shouldRender: (fileEntry: OutputFileEntry) => boolean;
+    onClick: (fileEntry: OutputFileEntry) => void | Promise<void>;
+};
+type PluginRegistryApi = {
+    registerSource: (source: PluginSourceRegistration) => PluginSourceRegistration;
+    registerActivity: (activity: PluginActivityRegistration) => PluginActivityRegistration;
+    registerFileAction: (fileAction: PluginFileActionRegistration) => PluginFileActionRegistration;
+    registerIcon: (icon: PluginIconRegistration) => PluginIconRegistration;
+    registerI18n: (i18n: PluginI18nRegistration) => PluginI18nRegistration;
+    registerConfig: <T = unknown>(definition: CustomConfigDefinition<T>) => void;
+};
+/**
+ * API for managing plugin config subscriptions
+ */
+type PluginConfigApi = {
+    /**
+     * Get the current value of a config option.
+     *
+     * @param configName - The name of the config to get
+     * @returns The current config value
+     *
+     * @example
+     * ```typescript
+     * const theme = pluginApi.config.get('my-theme');
+     * console.log('Current theme:', theme);
+     * ```
+     */
+    get: <T = unknown>(configName: keyof (ConfigType & CustomConfig)) => T;
+    /**
+     * Subscribe to changes in a custom config value.
+     * The callback will be called immediately with the current value,
+     * and then whenever the value changes.
+     *
+     * Subscriptions are automatically cleaned up when the plugin is disposed.
+     *
+     * @param configName - The name of the custom config to subscribe to
+     * @param callback - Function to call with the new value
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * pluginApi.config.subscribe('my-option', (value) => {
+     *   console.log('Config changed:', value);
+     * });
+     * // Cleanup happens automatically on plugin disposal
+     * ```
+     */
+    subscribe: <T = unknown>(configName: keyof (ConfigType & CustomConfig), callback: (value: T) => 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 PluginApi = {
+    registry: PluginRegistryApi;
+    config: PluginConfigApi;
+    activity: PluginActivityApi;
+};
+type PluginUploaderApi = UploaderPublicApi;
+type PluginExports = {
+    dispose?: () => void;
+};
+type PluginSetupResult = PluginExports | void | Promise<PluginExports | void>;
+type PluginSetupParams = {
+    pluginApi: PluginApi;
+    uploaderApi: PluginUploaderApi;
+};
+type UploaderPlugin = {
+    id: string;
+    version: PluginVersion;
+    setup: (params: PluginSetupParams) => PluginSetupResult;
+};
+type Owned<T> = T & {
+    pluginId: string;
+};
+type PluginRegistrySnapshot = {
+    sources: Owned<PluginSourceRegistration>[];
+    activities: Owned<PluginActivityRegistration>[];
+    fileActions: Owned<PluginFileActionRegistration>[];
+    icons: Owned<PluginIconRegistration>[];
+    i18n: Owned<PluginI18nRegistration>[];
+};
+
+declare class PluginManager extends SharedInstance {
+    private _plugins;
+    private _sources;
+    private _activities;
+    private _fileActions;
+    private _icons;
+    private _i18n;
+    private _subscribers;
+    private _pluginsUpdate;
+    readonly configRegistry: CustomConfigRegistry;
+    constructor(sharedInstancesBag: SharedInstancesBag);
+    onPluginsChange(callback: () => void): () => void;
+    private _syncPlugins;
+    private _registerPlugin;
+    private _unregisterPlugin;
+    snapshot(): PluginRegistrySnapshot;
     destroy(): void;
+    private _register;
+    private _purgeRegistrations;
+    private _notifySubscribers;
 }
 
 type CommonEventType = InternalEventKey | EventKey;
@@ -2076,14 +2358,71 @@ 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";
+    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;
+};
+
+declare class A11y implements ISharedInstance {
+    private _destroyKeyUX;
+    private readonly _scopedWindow;
+    constructor();
+    registerBlock(scope: LitBlock): void;
+    destroy(): void;
+}
+
 type SharedConfigState = {
     [K in keyof ConfigType as `*cfg/${K}`]: ConfigType[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;
 };
@@ -2150,13 +2489,16 @@ type EditorToolbarState = {
     '*currentOperation': string | null;
     '*operationTooltip': string | null;
 };
+type SharedContextInstances = Map<string, ISharedInstance>;
 type DynamicBlockState = {
+    '*sharedContextInstances': SharedContextInstances;
     '*blocksRegistry': BlocksRegistry;
     '*eventEmitter': EventEmitter;
     '*localeManager': LocaleManager;
     '*telemetryManager': TelemetryManager;
     '*a11y': A11y;
     '*modalManager': ModalManager | null;
+    '*pluginManager': PluginManager;
 };
 type DynamicUploaderBlockState = {
     '*uploadCollection': TypedCollection<UploadEntryData>;
@@ -2169,65 +2511,6 @@ type LocaleState = {
 };
 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' | '*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;
-}
-
 declare const LitBlockBase: typeof LitElement & Constructor<{
     willYield: boolean;
     yield(slot: string, defaultContent?: unknown): unknown;
@@ -2238,7 +2521,6 @@ 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$: {};
@@ -2248,6 +2530,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;
@@ -2257,6 +2540,19 @@ declare class LitBlock extends LitBlockBase {
         readonly secureUploadsManager: SecureUploadsManager;
         readonly api: UploaderPublicApi;
         readonly validationManager: ValidationManager;
+        when<TName extends "modalManager" | "pluginManager" | "telemetryManager" | "localeManager" | "a11y" | "blocksRegistry" | "eventEmitter" | "uploadCollection" | "secureUploadsManager" | "api" | "validationManager">(name: TName, callback: (instance: NonNullable<{
+            modalManager: ModalManager | null;
+            pluginManager: PluginManager;
+            telemetryManager: TelemetryManager;
+            localeManager: LocaleManager;
+            a11y: A11y;
+            blocksRegistry: BlocksRegistry;
+            eventEmitter: EventEmitter;
+            uploadCollection: TypedCollection<UploadEntryData>;
+            secureUploadsManager: SecureUploadsManager;
+            api: UploaderPublicApi;
+            validationManager: ValidationManager;
+        }[TName]>) => void): () => void;
     };
     emit(type: Parameters<EventEmitter['emit']>[0], payload?: Parameters<EventEmitter['emit']>[1], options?: Parameters<EventEmitter['emit']>[2]): void;
     hasBlockInCtx(callback: (block: LitBlock) => boolean): boolean;
@@ -2274,11 +2570,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];
@@ -2510,18 +2802,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 {
@@ -2530,9 +2824,11 @@ declare global {
     }
 }
 
-declare class SourceList extends LitBlock {
+declare class SourceList extends LitUploaderBlock {
     private _rawSourceList;
     private _cameraModes;
+    private _unsubscribePlugins?;
+    private _sources;
     /**
      * CSS-only attribute
      */
@@ -2540,8 +2836,12 @@ declare class SourceList extends LitBlock {
     initCallback(): void;
     protected updated(changedProperties: PropertyValues<this>): void;
     private _updateSources;
-    private _sources;
+    private _expandSource;
+    private _makeBuiltInSourceConfig;
+    private _makePluginSourceConfig;
+    private _openActivity;
     render(): lit_html.TemplateResult<1>;
+    disconnectedCallback(): void;
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -2604,13 +2904,11 @@ declare global {
 }
 
 declare class UrlSource extends LitUploaderBlock {
-    couldBeCtxOwner: boolean;
-    activityType: ActivityType;
     private _formState;
-    initCallback(): void;
     private _inputRef;
     private _handleInput;
     private _handleUpload;
+    firstUpdated(): void;
     render(): lit_html.TemplateResult<1>;
 }
 declare global {
@@ -2634,6 +2932,35 @@ declare global {
     }
 }
 
+declare class PluginActivityHost extends LitActivityBlock {
+    registration: Owned<PluginActivityRegistration>;
+    activityType: ActivityType;
+    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-plugin-activity-host': PluginActivityHost;
+        'uc-plugin-activity-renderer': PluginActivityRenderer;
+    }
+}
+
 declare class FileUploaderRegular extends LitSolutionBlock {
     attributesMeta: {
         headless?: boolean;
@@ -2694,4 +3021,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 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 PluginExports, type PluginFileActionRegistration, type PluginI18nRegistration, type PluginIconRegistration, PluginManager, type PluginRegistryApi, type PluginRegistrySnapshot, type PluginRender, type PluginRenderDispose, type PluginSetupParams, type PluginSetupResult, type PluginSourceRegistration, type PluginUploaderApi, type PluginVersion, 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 };