@pimcore/studio-ui-bundle 2026.1.0 → 2026.1.2

package/dist/build/types/src/core/modules/element/listing/abstract/configuration-layer/provider/selected-columns/selected-columns-provider.d.ts

@@ -33,5 +33,6 @@ export interface SelectedColumnsContextProps {
 export declare const SelectedColumnsContext: React.Context<SelectedColumnsContextProps>;
 export interface SelectedColumnsProviderProps {
     children: React.ReactNode;
+    columns?: SelectedColumn[];
 }
-export declare const SelectedColumnsProvider: ({ children }: SelectedColumnsProviderProps) => React.JSX.Element;
+export declare const SelectedColumnsProvider: ({ children, columns: controlledColumns }: SelectedColumnsProviderProps) => React.JSX.Element;

package/dist/build/types/src/core/modules/element/listing/decorators/general-filters/view-layer/components/sidebar/tabs/filters/filter-container.d.ts

@@ -8,9 +8,4 @@
  *  @license    Pimcore Open Core License (POCL)
  */
 import React from 'react';
-import { type FetchBaseQueryError } from '@reduxjs/toolkit/query';
-interface IFilterContainerProps {
-    errorData?: FetchBaseQueryError;
-}
-export declare const FilterContainer: ({ errorData }: IFilterContainerProps) => React.JSX.Element;
-export {};
+export declare const FilterContainer: () => React.JSX.Element;

package/dist/build/types/src/core/modules/element/search-replace-assignments/usage-api-slice-enhanced.d.ts

@@ -68,7 +68,7 @@ export declare const useLazyElementGetUsageQuery: <R extends Record<string, any>
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -158,7 +158,7 @@ export declare const useLazyElementGetUsageQuery: <R extends Record<string, any>
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;

package/dist/build/types/src/core/modules/element/search-replace-assignments/usage-api-slice.gen.d.ts

@@ -130,7 +130,7 @@ export declare const useElementGetUsageQuery: <R extends Record<string, any> = i
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -223,7 +223,7 @@ export declare const useElementGetUsageQuery: <R extends Record<string, any> = i
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;

package/dist/build/types/src/core/modules/email/emails-api-slice-enhanced.d.ts

@@ -78,7 +78,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -171,7 +171,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;
@@ -582,7 +582,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -675,7 +675,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;
@@ -766,7 +766,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -859,7 +859,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;
@@ -1110,7 +1110,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -1203,7 +1203,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;
@@ -1294,7 +1294,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -1387,7 +1387,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;
@@ -1478,7 +1478,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -1571,7 +1571,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;

package/dist/build/types/src/core/modules/email/emails-api-slice.gen.d.ts

@@ -256,7 +256,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -349,7 +349,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;
@@ -760,7 +760,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -853,7 +853,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;
@@ -944,7 +944,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -1037,7 +1037,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;
@@ -1288,7 +1288,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -1381,7 +1381,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;
@@ -1472,7 +1472,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -1565,7 +1565,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;
@@ -1656,7 +1656,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -1749,7 +1749,7 @@ export declare const useEmailBlocklistGetCollectionQuery: <R extends Record<stri
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;

package/dist/build/types/src/core/modules/execution-engine/execution-engine-api-slice-enhanced.d.ts

@@ -384,7 +384,7 @@ export declare const useExecutionEngineAbortJobRunByIdMutation: <R extends Recor
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -477,7 +477,7 @@ export declare const useExecutionEngineAbortJobRunByIdMutation: <R extends Recor
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;

package/dist/build/types/src/core/modules/execution-engine/execution-engine-api-slice.gen.d.ts

@@ -444,7 +444,7 @@ export declare const useExecutionEngineAbortJobRunByIdMutation: <R extends Recor
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+}, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
     isSuccess: true;
     isFetching: false;
     error: undefined;
@@ -537,7 +537,7 @@ export declare const useExecutionEngineAbortJobRunByIdMutation: <R extends Recor
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "error" | "fulfilledTimeStamp" | "isFetching" | "isSuccess" | "currentData"> & {
+    }, "data" | "error" | "fulfilledTimeStamp" | "currentData" | "isFetching" | "isSuccess"> & {
         isSuccess: true;
         isFetching: false;
         error: undefined;

package/dist/build/types/src/core/modules/execution-engine/jobs/batch-edit/abstract-batch-edit-job.d.ts

@@ -8,6 +8,7 @@
  *  @license    Pimcore Open Core License (POCL)
  */
 import { type JobInterface, type JobRunOptions } from '../job-interface';
+import { MessageBusJobHandler, type MessageBusJobHandlerOptions } from '../../message-handlers/message-bus-job/message-bus-job-handler';
 export interface AbstractBatchEditJobOptions {
     title: string;
     assetContextId: number;
@@ -21,6 +22,7 @@ export declare abstract class AbstractBatchEditJob implements JobInterface {
     protected readonly refreshGrid: () => Promise<void>;
     constructor(options: AbstractBatchEditJobOptions);
     run(options: JobRunOptions): Promise<void>;
+    protected createHandler(options: MessageBusJobHandlerOptions): MessageBusJobHandler;
     protected abstract executeEditRequest(): Promise<number | null>;
     protected handleCompletion(): Promise<void>;
     protected handleJobFailure(error: any): Promise<void>;

package/dist/build/types/src/core/modules/execution-engine/jobs/batch-edit/abstract-folder-batch-edit-job.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This source file is available under the terms of the
+ * Pimcore Open Core License (POCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
+ *  @license    Pimcore Open Core License (POCL)
+ */
+import { AbstractBatchEditJob, type AbstractBatchEditJobOptions } from './abstract-batch-edit-job';
+import { MessageBusJobHandler, type MessageBusJobHandlerOptions } from '../../message-handlers/message-bus-job/message-bus-job-handler';
+export type AbstractFolderBatchEditJobOptions = AbstractBatchEditJobOptions;
+export declare abstract class AbstractFolderBatchEditJob extends AbstractBatchEditJob {
+    protected createHandler(options: MessageBusJobHandlerOptions): MessageBusJobHandler;
+}

package/dist/build/types/src/core/modules/execution-engine/jobs/batch-edit/asset-folder-batch-edit-job.d.ts

@@ -7,14 +7,15 @@
  *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
  *  @license    Pimcore Open Core License (POCL)
  */
-import { AbstractBatchEditJob, type AbstractBatchEditJobOptions } from './abstract-batch-edit-job';
+import { AbstractFolderBatchEditJob } from './abstract-folder-batch-edit-job';
+import { type AbstractBatchEditJobOptions } from './abstract-batch-edit-job';
 export interface AssetFolderBatchEditJobOptions extends AbstractBatchEditJobOptions {
     patchAssetsInFolder: (args: any) => Promise<any>;
     folderId: number;
     patches: any[];
     filters: any;
 }
-export declare class AssetFolderBatchEditJob extends AbstractBatchEditJob {
+export declare class AssetFolderBatchEditJob extends AbstractFolderBatchEditJob {
     private readonly patchAssetsInFolder;
     private readonly folderId;
     private readonly patches;

package/dist/build/types/src/core/modules/execution-engine/jobs/batch-edit/data-object-folder-batch-edit-job.d.ts

@@ -7,7 +7,8 @@
  *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
  *  @license    Pimcore Open Core License (POCL)
  */
-import { AbstractBatchEditJob, type AbstractBatchEditJobOptions } from './abstract-batch-edit-job';
+import { AbstractFolderBatchEditJob } from './abstract-folder-batch-edit-job';
+import { type AbstractBatchEditJobOptions } from './abstract-batch-edit-job';
 export interface DataObjectFolderBatchEditJobOptions extends AbstractBatchEditJobOptions {
     patchObjectsInFolder: (args: any) => Promise<any>;
     folderId: number;
@@ -15,7 +16,7 @@ export interface DataObjectFolderBatchEditJobOptions extends AbstractBatchEditJo
     filters: any;
     classId: string;
 }
-export declare class DataObjectFolderBatchEditJob extends AbstractBatchEditJob {
+export declare class DataObjectFolderBatchEditJob extends AbstractFolderBatchEditJob {
     private readonly patchObjectsInFolder;
     private readonly folderId;
     private readonly values;

package/dist/build/types/src/core/modules/execution-engine/jobs/download/download-job.d.ts

@@ -12,6 +12,12 @@ export interface DownloadJobOptions {
     title: string;
     action: () => Promise<number>;
     downloadUrl: string;
+    /**
+     * Set to true for folder exports that spawn a child job (collect → create file).
+     * Shows "Step 1/2" / "Step 2/2" in the UI.
+     * Leave unset for selected-row exports (single job run, no child).
+     */
+    hasChildJob?: boolean;
 }
 export declare class DownloadJob implements JobInterface {
     private readonly options;

package/dist/build/types/src/core/modules/execution-engine/message-handlers/message-bus-job/message-bus-job-handler-types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * This source file is available under the terms of the
+ * Pimcore Open Core License (POCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
+ *  @license    Pimcore Open Core License (POCL)
+ */
+import { type JobStatus, type AbstractJob } from '../../../../modules/execution-engine/jobs/abstact-job';
+import { type JobButtonCustomizationContext } from './message-bus-job-notification';
+import { type ProgressCalculator } from './progress-calculator/progress-calculator.interface';
+import { type StepTracker } from './step-tracker/step-tracker.interface';
+export interface MessageBusJob extends AbstractJob {
+    progress?: number;
+    indeterminate?: boolean;
+    currentStep?: number;
+    totalSteps?: number;
+    stepDescriptionKey?: string;
+    onRetry?: () => void | Promise<void>;
+    onCustomizeButtons?: (context: JobButtonCustomizationContext) => void;
+    messages?: string[];
+    jobRunId: number;
+}
+export interface JobCompletionData {
+    isSuccessful: boolean;
+    isFinished: boolean;
+    isFailed: boolean;
+    status: JobStatus;
+    payload: any;
+}
+export interface MessageBusJobHandlerOptions {
+    jobRunId: number;
+    title: string | ((job: MessageBusJob) => string);
+    stepDescriptions?: Record<number, string>;
+    stepTracker?: StepTracker;
+    progressCalculator?: ProgressCalculator;
+    onJobCompletion?: (data: JobCompletionData) => void | Promise<void>;
+    onRetry?: () => void | Promise<void>;
+    onCustomizeButtons?: (context: JobButtonCustomizationContext) => void;
+}

package/dist/build/types/src/core/modules/execution-engine/message-handlers/message-bus-job/message-bus-job-handler.d.ts

@@ -9,23 +9,20 @@
  */
 import { AbstractMessageHandler } from '../../../../modules/global-message-bus/message-handlers/abstract-message-handler';
 import { type AbstractMercureMessage } from '../../../../modules/background-processor/process/abstract-mercure-process';
-import { JobStatus, type AbstractJob } from '../../../../modules/execution-engine/jobs/abstact-job';
-import { type JobButtonCustomizationContext } from './message-bus-job-notification';
-/**
- * Default job handler that provides common functionality for job management, Redux integration, status mapping, and progress handling
- * Can be used directly or extended by specific job handlers
- */
+import { type MessageBusJobHandlerOptions } from './message-bus-job-handler-types';
+export type { MessageBusJob, JobCompletionData, MessageBusJobHandlerOptions } from './message-bus-job-handler-types';
 export declare class MessageBusJobHandler extends AbstractMessageHandler {
     private jobRunId;
     private job;
     private readonly onJobCompletion?;
     private readonly onRetry?;
     private readonly onCustomizeButtons?;
-    private currentStep;
-    private readonly totalSteps?;
+    private readonly stepTracker;
+    private readonly stepDescriptions?;
+    private readonly progressCalculator;
     private lastProgressValue;
     private readonly title;
-    private readonly polling;
+    private polling;
     private readonly throttledProgressUpdate;
     constructor(options: MessageBusJobHandlerOptions);
     shouldHandle(message: AbstractMercureMessage): boolean;
@@ -34,11 +31,6 @@ export declare class MessageBusJobHandler extends AbstractMessageHandler {
     handleMessage(message: AbstractMercureMessage): Promise<void>;
     onUnregister(): void;
     private getTitle;
-    /**
-     * Calculate progress percent from message data
-     * Handles both step-based progress (if totalSteps > 1) and direct progress values (0-100)
-     */
-    private calculateProgress;
     private handleJobCompletion;
     private getJob;
     private createJob;
@@ -50,27 +42,3 @@ export declare class MessageBusJobHandler extends AbstractMessageHandler {
     private handlePolledStatusUpdate;
     private processUpdate;
 }
-export interface MessageBusJob extends AbstractJob {
-    progress?: number;
-    currentStep?: number;
-    totalSteps?: number;
-    onRetry?: () => void | Promise<void>;
-    onCustomizeButtons?: (context: JobButtonCustomizationContext) => void;
-    messages?: string[];
-    jobRunId: number;
-}
-export interface JobCompletionData {
-    isSuccessful: boolean;
-    isFinished: boolean;
-    isFailed: boolean;
-    status: JobStatus;
-    payload: any;
-}
-export interface MessageBusJobHandlerOptions {
-    jobRunId: number;
-    title: string | ((job: MessageBusJob) => string);
-    totalSteps?: number;
-    onJobCompletion?: (data: JobCompletionData) => void | Promise<void>;
-    onRetry?: () => void | Promise<void>;
-    onCustomizeButtons?: (context: JobButtonCustomizationContext) => void;
-}

package/dist/build/types/src/core/modules/execution-engine/message-handlers/message-bus-job/message-bus-job-notification.d.ts

@@ -11,6 +11,7 @@ import React from 'react';
 import { type ButtonAction } from '../../../../modules/execution-engine/notification/job/job-view';
 import { type MessageBusJob } from './message-bus-job-handler';
 export interface JobButtonCustomizationContext {
+    jobRunId: number;
     addSuccessButton: (action: ButtonAction, position?: 'start' | 'end') => void;
     addFinishedWithErrorsButton: (action: ButtonAction, position?: 'start' | 'end') => void;
     addFailureButton: (action: ButtonAction, position?: 'start' | 'end') => void;

package/dist/build/types/src/core/modules/execution-engine/message-handlers/message-bus-job/progress-calculator/progress-calculator.interface.d.ts

@@ -0,0 +1,46 @@
+/**
+ * This source file is available under the terms of the
+ * Pimcore Open Core License (POCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
+ *  @license    Pimcore Open Core License (POCL)
+ */
+/**
+ * Sentinel value returned by a ProgressCalculator to signal that the progress
+ * bar should not be updated at all (e.g. no relevant data in the message).
+ *
+ * Distinct from `null` which signals an indeterminate (spinner) state.
+ */
+export declare const PROGRESS_NO_UPDATE: unique symbol;
+/**
+ * The result of a progress calculation:
+ *
+ * - `number`             – determinate progress value (0–100)
+ * - `null`               – indeterminate state (show spinner)
+ * - `PROGRESS_NO_UPDATE` – skip update entirely, leave bar as-is
+ */
+export type ProgressResult = number | null | typeof PROGRESS_NO_UPDATE;
+export interface ProgressCalculatorContext {
+    /** Current step as tracked by the step tracker */
+    currentStep: number;
+    /** Total steps if known */
+    totalSteps?: number;
+    /** Last progress value successfully applied (-1 if none yet) */
+    lastProgressValue: number;
+}
+export interface ProgressCalculator {
+    /**
+     * Calculate the progress result from a raw SSE message payload.
+     *
+     * @param data    Raw message payload from the backend
+     * @param context Current handler state
+     */
+    calculateProgress: (data: any, context: ProgressCalculatorContext) => ProgressResult;
+    /**
+     * Called when the step advances (same-job step change or child job transition).
+     * Calculators that maintain internal state should reset it here.
+     */
+    onStepChange?: () => void;
+}

package/dist/build/types/src/core/modules/execution-engine/message-handlers/message-bus-job/progress-calculator/progress-field-calculator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * This source file is available under the terms of the
+ * Pimcore Open Core License (POCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
+ *  @license    Pimcore Open Core License (POCL)
+ */
+import { type ProgressCalculator, type ProgressCalculatorContext, type ProgressResult } from './progress-calculator.interface';
+/**
+ * Reads the backend `progress` field (0–100) directly.
+ *
+ * Distinguishes between gradual steps and instant steps:
+ *   - Gradual step: backend sends progress 0 → 100 over multiple messages → smooth bar
+ *   - Instant step: backend sends only progress 100 in one message → spinner (null)
+ *
+ * When the step tracker has a known totalSteps and the backend reports finer-grained
+ * sub-steps within a child job (different totalSteps value), the two are combined:
+ *   combined = ((subStep - 1) / subTotal) * 100 + progress / subTotal
+ *
+ * Internal gradual-progress state resets on every step change via onStepChange().
+ *
+ * Used for: batch-edit folder, zip-upload, CSV/XLSX export (all variants).
+ */
+export declare class ProgressFieldCalculator implements ProgressCalculator {
+    private hadGradualProgress;
+    calculateProgress(data: any, context: ProgressCalculatorContext): ProgressResult;
+    onStepChange(): void;
+}

package/dist/build/types/src/core/modules/execution-engine/message-handlers/message-bus-job/progress-calculator/step-completion-calculator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * This source file is available under the terms of the
+ * Pimcore Open Core License (POCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
+ *  @license    Pimcore Open Core License (POCL)
+ */
+import { type ProgressCalculator, type ProgressCalculatorContext, type ProgressResult } from './progress-calculator.interface';
+/**
+ * Calculates progress from completed steps: step N done = N / totalSteps * 100%.
+ *
+ * Each step is considered complete when the backend sends progress: 100.
+ * While a step is still running (progress < 100), the bar holds at the
+ * previous step boundary.
+ *
+ *   step 1/7 completes → 14%
+ *   step 2/7 completes → 29%
+ *   step 7/7 completes → 100%
+ *
+ * Falls back to the raw progress field for single-step jobs (totalSteps === 1
+ * or totalSteps unknown).
+ *
+ * Used for: delete, batch-delete — one step per element, instant completion.
+ */
+export declare class StepCompletionCalculator implements ProgressCalculator {
+    calculateProgress(data: any, context: ProgressCalculatorContext): ProgressResult;
+}