@gooddata/sdk-ui-dashboard 11.55.0-alpha.3 → 11.55.0-alpha.4

package/esm/sdk-ui-dashboard.d.ts

@@ -25,9 +25,13 @@ import { CurrentUserPermissions } from '@gooddata/sdk-ui-kit';
 import { DashboardAttachmentType } from '@gooddata/sdk-model';
 import { DashboardAttributeFilterConfigMode } from '@gooddata/sdk-model';
 import { DashboardAttributeFilterItem } from '@gooddata/sdk-model';
+import { dashboardAttributeFilterItemToAttributeFilter } from '@gooddata/sdk-model';
 import { DashboardAttributeFilterSelectionMode } from '@gooddata/sdk-model';
 import { DashboardAttributeFilterSelectionType } from '@gooddata/sdk-model';
+import { dashboardAttributeFilterToAttributeFilter } from '@gooddata/sdk-model';
 import { DashboardDateFilterConfigMode } from '@gooddata/sdk-model';
+import { dashboardDateFilterToDateFilterByDateDataSet } from '@gooddata/sdk-model';
+import { dashboardDateFilterToDateFilterByWidget } from '@gooddata/sdk-model';
 import { DashboardFiltersApplyMode } from '@gooddata/sdk-model';
 import { DashboardParameterMode } from '@gooddata/sdk-model';
 import { DashboardSummaryWorkflowStatus } from '@gooddata/sdk-backend-spi';
@@ -46,10 +50,14 @@ import { EntityState } from '@reduxjs/toolkit';
 import { ExecutionResultLimitType } from '@gooddata/sdk-model';
 import { ExplicitDrill } from '@gooddata/sdk-ui';
 import { FilterContextItem } from '@gooddata/sdk-model';
+import { filterContextItemsToDashboardFiltersByDateDataSet } from '@gooddata/sdk-model';
+import { filterContextItemsToDashboardFiltersByRichTextWidget } from '@gooddata/sdk-model';
+import { filterContextItemsToDashboardFiltersByWidget } from '@gooddata/sdk-model';
+import { filterContextToDashboardFiltersByDateDataSet } from '@gooddata/sdk-model';
+import { filterContextToDashboardFiltersByWidget } from '@gooddata/sdk-model';
 import { FocusEvent as FocusEvent_2 } from 'react';
 import { ForwardRefExoticComponent } from 'react';
 import { GoodDataSdkError } from '@gooddata/sdk-ui';
-import { IAbsoluteDateFilter } from '@gooddata/sdk-model';
 import { IAccessControlAware } from '@gooddata/sdk-model';
 import { IAccessGrantee } from '@gooddata/sdk-model';
 import { IActiveCalendars } from '@gooddata/sdk-model';
@@ -61,7 +69,6 @@ import { IAlertRelativeOperator } from '@gooddata/sdk-model';
 import { IAlertTriggerInterval } from '@gooddata/sdk-model';
 import { IAlertTriggerMode } from '@gooddata/sdk-model';
 import { IAnalyticalBackend } from '@gooddata/sdk-backend-spi';
-import { IArbitraryAttributeFilter } from '@gooddata/sdk-model';
 import { IAttribute } from '@gooddata/sdk-model';
 import { IAttributeDescriptorBody } from '@gooddata/sdk-model';
 import { IAttributeDisplayFormMetadataObject } from '@gooddata/sdk-model';
@@ -100,6 +107,7 @@ import { IDashboardDefinition } from '@gooddata/sdk-model';
 import { IDashboardExportParameter } from '@gooddata/sdk-model';
 import { IDashboardExportPresentationOptions } from '@gooddata/sdk-backend-spi';
 import { IDashboardExportRawOptions } from '@gooddata/sdk-backend-spi';
+import { IDashboardFilter as IDashboardFilter_2 } from '@gooddata/sdk-model';
 import { IDashboardFilterGroup } from '@gooddata/sdk-model';
 import { IDashboardFilterGroupsConfig } from '@gooddata/sdk-model';
 import { IDashboardFilterReference } from '@gooddata/sdk-model';
@@ -149,7 +157,6 @@ import { IExportResult } from '@gooddata/sdk-backend-spi';
 import { IExportTemplate } from '@gooddata/sdk-model';
 import { IFilter } from '@gooddata/sdk-model';
 import { IFilterableWidget } from '@gooddata/sdk-model';
-import { IFilterContext } from '@gooddata/sdk-model';
 import { IFilterContextDefinition } from '@gooddata/sdk-model';
 import { IHeaderPredicate } from '@gooddata/sdk-ui';
 import { IInsight } from '@gooddata/sdk-model';
@@ -170,13 +177,11 @@ import { IListedDashboard } from '@gooddata/sdk-model';
 import { ILoadingProps } from '@gooddata/sdk-ui';
 import { ILocale } from '@gooddata/sdk-ui';
 import { ILowerBoundedFilter } from '@gooddata/sdk-model';
-import { IMatchAttributeFilter } from '@gooddata/sdk-model';
 import { IMeasure } from '@gooddata/sdk-model';
 import { IMeasureDescriptor } from '@gooddata/sdk-model';
 import { IMeasureMetadataObject } from '@gooddata/sdk-model';
 import { IMeasureValueFilter } from '@gooddata/sdk-model';
 import { IMeasureValueFilterProps } from '@gooddata/sdk-ui-filters';
-import { INegativeAttributeFilter } from '@gooddata/sdk-model';
 import { INotificationChannelIdentifier } from '@gooddata/sdk-model';
 import { INotificationChannelMetadataObject } from '@gooddata/sdk-model';
 import { INotificationChannelMetadataObjectBase } from '@gooddata/sdk-model';
@@ -185,13 +190,12 @@ import { InsightDrillDefinition } from '@gooddata/sdk-model';
 import { IntlShape } from 'react-intl';
 import { IParameterDefinition } from '@gooddata/sdk-model';
 import { IParameterMetadataObject } from '@gooddata/sdk-model';
-import { IPositiveAttributeFilter } from '@gooddata/sdk-model';
 import { IPushData } from '@gooddata/sdk-ui';
 import { IRawExportCustomOverrides } from '@gooddata/sdk-backend-spi';
-import { IRelativeDateFilter } from '@gooddata/sdk-model';
 import { IRenderListItemProps } from '@gooddata/sdk-ui-kit';
 import { IResultWarning } from '@gooddata/sdk-model';
 import { IRichTextWidget } from '@gooddata/sdk-model';
+import { isDashboardFilter as isDashboardFilter_2 } from '@gooddata/sdk-model';
 import { ISeparators } from '@gooddata/sdk-model';
 import { ISettings } from '@gooddata/sdk-model';
 import { IShareDialogInteractionData } from '@gooddata/sdk-ui-kit';
@@ -199,7 +203,6 @@ import { ISharedObject } from '@gooddata/sdk-ui-kit';
 import { ISharingApplyPayload as ISharingApplyPayload_2 } from '@gooddata/sdk-ui-kit';
 import { ISlotProps } from '@gooddata/sdk-ui-kit';
 import { ITableDataAttributeScope } from '@gooddata/sdk-ui';
-import { ITempFilterContext } from '@gooddata/sdk-model';
 import { ITheme } from '@gooddata/sdk-model';
 import type { ITranslations } from '@gooddata/sdk-ui';
 import { IUnavailableDashboardReference } from '@gooddata/sdk-backend-spi';
@@ -879,10 +882,26 @@ export declare function AlertingDialogTriggerMode(overrides: Partial<IAlertingDi
 export declare type AlertingDisabledReason = "noDestinations" | "oldWidget" | "disabledOnInsight";
 
 /**
+ * Resolves the management dialog component from DashboardComponentsContext and mounts it inside
+ * the resolved context decorator — so a decorated management context is what the dialog (default
+ * or replacement) reads.
+ *
  * @internal
  */
 export declare function AlertingManagementDialog(props: IAlertingManagementDialogProps): ReactElement;
 
+/**
+ * Provides the alerting management dialog context.
+ *
+ * The dashboard's connector mounts the original value. Exported so a context-decorator
+ * component (`CustomAlertingManagementDialogContextDecoratorComponent`) can re-provide a decorated
+ * value read from `useAlertingManagementDialogContext()`; it is not a way to run the management
+ * dialog outside a dashboard.
+ *
+ * @alpha
+ */
+export declare const AlertingManagementDialogContextProvider: Provider<IAlertingManagementDialogContextValue | undefined>;
+
 /**
  * A measure of the insight the alerting dialog can build a condition on, with the comparisons
  * available for it.
@@ -989,7 +1008,7 @@ export declare function anyEventHandler(handler: DashboardEventHandler["handler"
  * The {@link ChangeAttributeFilterSelectionPayload}'s `selectionType` and `elements` are derived from the
  * provided attribute filter.
  *
- * To convert {@link IDashboardFilter} to {@link @gooddata/sdk-model#IFilter} use {@link dashboardAttributeFilterToAttributeFilter}.
+ * To convert {@link IDashboardFilter} to {@link @gooddata/sdk-model#IFilter} use {@link @gooddata/sdk-model#dashboardAttributeFilterToAttributeFilter}.
  * Converted filter can be used within the command's payload.
  *
  * @param filterLocalId - dashboard attribute filter's local id
@@ -1172,6 +1191,18 @@ export declare type AutomationInteractionPayload = IUserInteractionPayloadWithDa
  */
 export declare type AutomationInteractionType = "scheduledExportInitialized" | "scheduledExportCreated" | "alertInitialized" | "alertCreated";
 
+/**
+ * Provides the automation dialogs' shared context.
+ *
+ * The dashboard's connectors mount the original value once per tree. Exported so a
+ * context-decorator component (`CustomAutomationsContextDecoratorComponent`) can re-provide a
+ * decorated value read from `useAutomationsContext()`; it is not a way to run the dialogs outside
+ * a dashboard.
+ *
+ * @alpha
+ */
+export declare const AutomationsContextProvider: Provider<IAutomationsContextValue | undefined>;
+
 /**
  * @public
  */
@@ -2266,6 +2297,12 @@ export declare type CustomAlertingDialogComponent = ComponentType<IAlertingDialo
  * false, and a decorator that overrides it corrupts the draft seed. Define the decorator
  * outside render, or the dialog remounts (and reseeds) on every parent render.
  *
+ * The contract: change the data, not what it means — every member keeps its documented meaning.
+ * The dialog does not check the decorated value; when you override a member, everything that
+ * reads it is your responsibility. Spread the value you read (`{ ...ctx, member }`) so the other
+ * members pass through. Wrap functions instead of replacing them. Do not touch members marked as
+ * internal machinery.
+ *
  * @alpha
  */
 export declare type CustomAlertingDialogContextDecoratorComponent = ComponentType<{
@@ -2277,6 +2314,106 @@ export declare type CustomAlertingDialogContextDecoratorComponent = ComponentTyp
  */
 export declare type CustomAlertingManagementDialogComponent = ComponentType<IAlertingManagementDialogProps>;
 
+/**
+ * Decorates the data the alerting management dialog reads.
+ *
+ * The dashboard mounts this component between the connector-provided management dialog context and
+ * the resolved management dialog component (default or replacement), so the value it re-provides is
+ * what the dialog reads. Read the current value with `useAlertingManagementDialogContext()`,
+ * decorate the members to adjust, and re-provide via `AlertingManagementDialogContextProvider`:
+ *
+ * @example
+ * ```tsx
+ * function AlertsListDecorator({ children }: { children?: ReactNode }) {
+ *     const ctx = useAlertingManagementDialogContext();
+ *     const { alerts, loading } = useMySelfFetchedAlerts(ctx.automations);
+ *     const decorated = useMemo(
+ *         () => ({ ...ctx, automations: alerts, isLoading: ctx.isLoading || loading }),
+ *         [ctx, alerts, loading],
+ *     );
+ *     return (
+ *         <AlertingManagementDialogContextProvider value={decorated}>
+ *             {children}
+ *         </AlertingManagementDialogContextProvider>
+ *     );
+ * }
+ * // <Dashboard AlertingManagementDialogContextDecoratorComponent={AlertsListDecorator} />
+ * ```
+ *
+ * The management dialog has no state seeding — it renders from the context on every change, so a
+ * decorator may replace `automations` or extend `isLoading` (as above). Extend `isLoading` only
+ * as `ctx.isLoading || yourOwnLoading`, never force it: forced false shows the list before its
+ * data arrives, forced true hides it forever. `isLoading` here covers the automations load only —
+ * deliberately narrower than the scheduled-email management context's flag. Define the decorator
+ * outside render, or the dialog remounts on every parent render.
+ *
+ * The contract: change the data, not what it means — every member keeps its documented meaning.
+ * The dialog does not check the decorated value; when you override a member, everything that
+ * reads it is your responsibility. Spread the value you read (`{ ...ctx, member }`) so the other
+ * members pass through. Wrap functions instead of replacing them. Do not touch members marked as
+ * internal machinery.
+ *
+ * @alpha
+ */
+export declare type CustomAlertingManagementDialogContextDecoratorComponent = ComponentType<{
+    children?: ReactNode;
+}>;
+
+/**
+ * Decorates the data the automation dialogs' shared context carries.
+ *
+ * The dashboard mounts this component directly inside each connector-provided automations context
+ * — once in the alerting tree and once in the scheduled-email tree — so the value it re-provides
+ * is what everything in both trees reads: the default dialogs, wholesale replacements, exported
+ * blocks and hooks, and the dialogs' state seeding. A decorator must therefore be tree-agnostic.
+ * Read the current value with `useAutomationsContext()`, decorate the members to adjust, and
+ * re-provide via `AutomationsContextProvider`:
+ *
+ * @example
+ * ```tsx
+ * function GranularityDecorator({ children }: { children?: ReactNode }) {
+ *     const ctx = useAutomationsContext();
+ *     const decorated = useMemo(
+ *         () => ({
+ *             ...ctx,
+ *             dateFilterConfig: {
+ *                 ...ctx.dateFilterConfig,
+ *                 availableGranularities: ctx.dateFilterConfig.availableGranularities.filter(
+ *                     (g) => g !== "GDC.time.hour",
+ *                 ),
+ *                 getGranularitiesForTab: (tabId: string) =>
+ *                     ctx.dateFilterConfig
+ *                         .getGranularitiesForTab(tabId)
+ *                         .filter((g) => g !== "GDC.time.hour"),
+ *             },
+ *         }),
+ *         [ctx],
+ *     );
+ *     return <AutomationsContextProvider value={decorated}>{children}</AutomationsContextProvider>;
+ * }
+ * // <Dashboard AutomationsContextDecoratorComponent={GranularityDecorator} />
+ * ```
+ *
+ * To constrain the date-filter granularities the dialogs offer, override
+ * `dateFilterConfig.availableGranularities` and `dateFilterConfig.getGranularitiesForTab`
+ * together, as above — the date filter falls back per tab. Components that build this context
+ * themselves (the standalone connected dialogs, the widget-panel alerts list) are not decorated.
+ * Define the decorator outside render, or both dialog trees remount on every parent render.
+ * Both instances mount with the dashboard, not only while a dialog is open — a decorator that
+ * fetches data runs on every dashboard.
+ *
+ * The contract: change the data, not what it means — every member keeps its documented meaning.
+ * The dialog does not check the decorated value; when you override a member, everything that
+ * reads it is your responsibility. Spread the value you read (`{ ...ctx, member }`) so the other
+ * members pass through. Wrap functions instead of replacing them. Do not touch members marked as
+ * internal machinery.
+ *
+ * @alpha
+ */
+export declare type CustomAutomationsContextDecoratorComponent = ComponentType<{
+    children?: ReactNode;
+}>;
+
 /**
  * @beta
  */
@@ -2510,6 +2647,12 @@ export declare type CustomScheduledEmailDialogComponent = ComponentType<ISchedul
  * corrupts the draft seed on every such open, not in an edge case. Define the decorator outside
  * render, or the dialog remounts (and reseeds) on every parent render.
  *
+ * The contract: change the data, not what it means — every member keeps its documented meaning.
+ * The dialog does not check the decorated value; when you override a member, everything that
+ * reads it is your responsibility. Spread the value you read (`{ ...ctx, member }`) so the other
+ * members pass through. Wrap functions instead of replacing them. Do not touch members marked as
+ * internal machinery.
+ *
  * @alpha
  */
 export declare type CustomScheduledEmailDialogContextDecoratorComponent = ComponentType<{
@@ -2521,6 +2664,53 @@ export declare type CustomScheduledEmailDialogContextDecoratorComponent = Compon
  */
 export declare type CustomScheduledEmailManagementDialogComponent = ComponentType<IScheduledEmailManagementDialogProps>;
 
+/**
+ * Decorates the data the scheduled email management dialog reads.
+ *
+ * The dashboard mounts this component between the connector-provided management dialog context and
+ * the resolved management dialog component (default or replacement), so the value it re-provides is
+ * what the dialog reads. Read the current value with `useScheduledEmailManagementDialogContext()`,
+ * decorate the members to adjust, and re-provide via
+ * `ScheduledEmailManagementDialogContextProvider`:
+ *
+ * @example
+ * ```tsx
+ * function SchedulesListDecorator({ children }: { children?: ReactNode }) {
+ *     const ctx = useScheduledEmailManagementDialogContext();
+ *     const { schedules, loading } = useMySelfFetchedSchedules(ctx.automations);
+ *     const decorated = useMemo(
+ *         () => ({ ...ctx, automations: schedules, isLoading: ctx.isLoading || loading }),
+ *         [ctx, schedules, loading],
+ *     );
+ *     return (
+ *         <ScheduledEmailManagementDialogContextProvider value={decorated}>
+ *             {children}
+ *         </ScheduledEmailManagementDialogContextProvider>
+ *     );
+ * }
+ * // <Dashboard ScheduledEmailManagementDialogContextDecoratorComponent={SchedulesListDecorator} />
+ * ```
+ *
+ * The management dialog has no state seeding — it renders from the context on every change, so a
+ * decorator may replace `automations` or extend `isLoading` (as above). Extend `isLoading` only
+ * as `ctx.isLoading || yourOwnLoading`, never force it: forced false shows the list before its
+ * data arrives, forced true hides it forever. `isLoading` here may also cover a widget-filters
+ * load while a widget-scoped create/edit dialog is open — deliberately broader than the alerting
+ * management context's automations-only flag. Define the decorator outside render, or the dialog
+ * remounts on every parent render.
+ *
+ * The contract: change the data, not what it means — every member keeps its documented meaning.
+ * The dialog does not check the decorated value; when you override a member, everything that
+ * reads it is your responsibility. Spread the value you read (`{ ...ctx, member }`) so the other
+ * members pass through. Wrap functions instead of replacing them. Do not touch members marked as
+ * internal machinery.
+ *
+ * @alpha
+ */
+export declare type CustomScheduledEmailManagementDialogContextDecoratorComponent = ComponentType<{
+    children?: ReactNode;
+}>;
+
 /**
  * @beta
  */
@@ -2675,24 +2865,14 @@ export declare type DashboardAttributeFilterItemSelectionReplacedPayload = {
     readonly filter: DashboardAttributeFilterItem;
 };
 
-/**
- * Converts any {@link @gooddata/sdk-model#DashboardAttributeFilterItem} to {@link @gooddata/sdk-model#IAttributeFilter} instance.
- *
- * @remarks
- * Handles all attribute filter types: element-based (positive/negative selection),
- * arbitrary value filters, and match (text) filters.
- *
- * @param filter - dashboard attribute filter item to convert
- * @public
- */
-export declare function dashboardAttributeFilterItemToAttributeFilter(filter: DashboardAttributeFilterItem): IAttributeFilter;
+export { dashboardAttributeFilterItemToAttributeFilter }
 
 /**
  * This event is emitted after new elements are selected and applied in an attribute filter.
  *
  * @remarks
  *
- * See also {@link dashboardAttributeFilterToAttributeFilter} convertor – this allows you to convert the `filter`
+ * See also {@link @gooddata/sdk-model#dashboardAttributeFilterToAttributeFilter} convertor – this allows you to convert the `filter`
  * in the event payload to an {@link @gooddata/sdk-model#IAttributeFilter} instance you can use with visualizations,
  * filter UI components and so on.
  *
@@ -2708,7 +2888,7 @@ export declare type DashboardAttributeFilterSelectionChanged = IDashboardEvent &
  *
  * @remarks
  *
- * See also {@link dashboardAttributeFilterToAttributeFilter} convertor – this allows you to convert the `filter`
+ * See also {@link @gooddata/sdk-model#dashboardAttributeFilterToAttributeFilter} convertor – this allows you to convert the `filter`
  * object to an {@link @gooddata/sdk-model#IAttributeFilter} instance you can use with visualizations,
  * filter UI components and so on.
  *
@@ -2723,15 +2903,7 @@ export declare type DashboardAttributeFilterSelectionChangedPayload = {
     readonly filter: IDashboardAttributeFilter;
 };
 
-/**
- * Converts {@link @gooddata/sdk-backend-spi#IDashboardAttributeFilter} to {@link @gooddata/sdk-model#IAttributeFilter} instance.
- *
- * @param filter - filter context attribute filter to convert
- * @deprecated Use {@link dashboardAttributeFilterItemToAttributeFilter} instead,
- * which supports all attribute filter types including text filters.
- * @public
- */
-export declare function dashboardAttributeFilterToAttributeFilter(filter: IDashboardAttributeFilter): IAttributeFilter;
+export { dashboardAttributeFilterToAttributeFilter }
 
 /**
  * Union type that contains all available built-in dashboard commands.
@@ -3177,7 +3349,7 @@ export declare type DashboardCopySavedPayload = {
  *
  * @remarks
  *
- * See also {@link dashboardDateFilterToDateFilterByWidget} and {@link dashboardDateFilterToDateFilterByDateDataSet} convertors
+ * See also {@link @gooddata/sdk-model#dashboardDateFilterToDateFilterByWidget} and {@link @gooddata/sdk-model#dashboardDateFilterToDateFilterByDateDataSet} convertors
  * – those allow you to convert the `filter` in the event payload to an {@link @gooddata/sdk-model#IDateFilter} instance you can use
  * with visualizations, filter UI components and so on.
  *
@@ -3193,7 +3365,7 @@ export declare type DashboardDateFilterSelectionChanged = IDashboardEvent & {
  *
  * @remarks
  *
- * See also {@link dashboardDateFilterToDateFilterByWidget} and {@link dashboardDateFilterToDateFilterByDateDataSet} convertors
+ * See also {@link @gooddata/sdk-model#dashboardDateFilterToDateFilterByWidget} and {@link @gooddata/sdk-model#dashboardDateFilterToDateFilterByDateDataSet} convertors
  * – those allow you to convert the `filter` object to an {@link @gooddata/sdk-model#IDateFilter} instance you can use
  * with visualizations, filter UI components and so on.
  *
@@ -3210,23 +3382,9 @@ export declare type DashboardDateFilterSelectionChangedPayload = {
     readonly dateFilterOptionLocalId?: string;
 };
 
-/**
- * Converts {@link @gooddata/sdk-backend-spi#IDashboardDateFilter} to {@link @gooddata/sdk-model#IDateFilter} instance.
- *
- * @param filter - filter context attribute filter to convert
- * @param dateDataSet - date data set to define {@link @gooddata/sdk-model#IDateFilter}
- * @public
- */
-export declare function dashboardDateFilterToDateFilterByDateDataSet(filter: IDashboardDateFilter, dateDataSet: ObjRef): IDateFilter;
+export { dashboardDateFilterToDateFilterByDateDataSet }
 
-/**
- * Converts {@link @gooddata/sdk-backend-spi#IDashboardDateFilter} to {@link @gooddata/sdk-model#IDateFilter} instance.
- *
- * @param filter - filter context attribute filter to convert
- * @param widget - widget to use to get dateDataSet for date filters
- * @public
- */
-export declare function dashboardDateFilterToDateFilterByWidget(filter: IDashboardDateFilter, widget?: Partial<IFilterableWidget>): IDateFilter;
+export { dashboardDateFilterToDateFilterByWidget }
 
 /**
  * This event is emitted when a dashboard is deinitialized. The event contains contextual information such as
@@ -3375,7 +3533,7 @@ export declare type DashboardEventType = "GDC.DASH/EVT.COMMAND.FAILED" | "GDC.DA
  * This event is emitted as convenience - more granular events describe all the possible
  * changes to the dashboard filters and can be used to even source the state of filter context.
  *
- * See also {@link filterContextToDashboardFiltersByWidget} and {@link filterContextToDashboardFiltersByDateDataSet} convertors
+ * See also {@link @gooddata/sdk-model#filterContextToDashboardFiltersByWidget} and {@link @gooddata/sdk-model#filterContextToDashboardFiltersByDateDataSet} convertors
  * – those allow you to convert the `filterContext` in the event payload to array of {@link @gooddata/sdk-model#IFilter} instances you can use
  * with visualizations, filter UI components and so on.
  *
@@ -3391,7 +3549,7 @@ export declare type DashboardFilterContextChanged = IDashboardEvent & {
  *
  * @remarks
  *
- * See also {@link filterContextToDashboardFiltersByWidget} and {@link filterContextToDashboardFiltersByDateDataSet} convertors
+ * See also {@link @gooddata/sdk-model#filterContextToDashboardFiltersByWidget} and {@link @gooddata/sdk-model#filterContextToDashboardFiltersByDateDataSet} convertors
  * – those allow you to convert the `filterContext` object to array of {@link @gooddata/sdk-model#IFilter} instances you can use
  * with visualizations, filter UI components and so on.
  *
@@ -5806,32 +5964,11 @@ export declare type FilterBarMeasureValueFilterIndexed = {
  */
 export declare type FilterBarRenderingMode = "default" | "hidden";
 
-/**
- * Gets {@link IDashboardFilter} items for filters specified as {@link @gooddata/sdk-backend-spi#FilterContextItem} instances.
- *
- * @param filterContextItems - filter context items to get filters for
- * @param dateDataSet - date data set to define {@link @gooddata/sdk-model#IDateFilter}
- * @public
- */
-export declare function filterContextItemsToDashboardFiltersByDateDataSet(filterContextItems: FilterContextItem[], dateDataSet: ObjRef): IDashboardFilter[];
+export { filterContextItemsToDashboardFiltersByDateDataSet }
 
-/**
- * Gets {@link IDashboardFilter} items for filters specified as {@link @gooddata/sdk-backend-spi#FilterContextItem} instances.
- *
- * @param filterContextItems - filter context items to get filters for
- * @param widget - widget to use to get dateDataSet for date filters
- * @public
- */
-export declare function filterContextItemsToDashboardFiltersByRichTextWidget(filterContextItems: FilterContextItem[], widget?: Partial<IFilterableWidget>): IDashboardFilter[];
+export { filterContextItemsToDashboardFiltersByRichTextWidget }
 
-/**
- * Gets {@link IDashboardFilter} items for filters specified as {@link @gooddata/sdk-backend-spi#FilterContextItem} instances.
- *
- * @param filterContextItems - filter context items to get filters for
- * @param widget - widget to use to get dateDataSet for date filters
- * @public
- */
-export declare function filterContextItemsToDashboardFiltersByWidget(filterContextItems: FilterContextItem[], widget?: Partial<IFilterableWidget>): IDashboardFilter[];
+export { filterContextItemsToDashboardFiltersByWidget }
 
 /**
  * @alpha
@@ -5910,24 +6047,9 @@ export declare type FilterContextState = {
     defaultFilterOverrides?: FilterContextItem[];
 };
 
-/**
- * Gets {@link IDashboardFilter} items for filters specified in given filterContext in relation to the
- * given dateDataSet.
- *
- * @param filterContext - filter context to get filters for
- * @param dateDataSet - widget to use to get dateDataSet for date filters
- * @public
- */
-export declare function filterContextToDashboardFiltersByDateDataSet(filterContext: IFilterContextDefinition | IFilterContext | ITempFilterContext | undefined, dateDataSet: ObjRef): IDashboardFilter[];
+export { filterContextToDashboardFiltersByDateDataSet }
 
-/**
- * Gets {@link IDashboardFilter} items for filters specified in given filterContext in relation to the given widget.
- *
- * @param filterContext - filter context to get filters for
- * @param widget - widget to use to get dateDataSet for date filters
- * @public
- */
-export declare function filterContextToDashboardFiltersByWidget(filterContext: IFilterContextDefinition | IFilterContext | ITempFilterContext | undefined, widget: IWidgetDefinition): IDashboardFilter[];
+export { filterContextToDashboardFiltersByWidget }
 
 /**
  * @alpha
@@ -10105,12 +10227,41 @@ export declare interface IDashboardCustomComponentProps {
      * @alpha
      */
     ScheduledEmailManagementDialogComponent?: CustomScheduledEmailManagementDialogComponent;
+    /**
+     * Specify component to decorate the data the scheduled email management dialog reads.
+     *
+     * Rendered between the connector-provided management dialog context and the resolved
+     * management dialog component; see `CustomScheduledEmailManagementDialogContextDecoratorComponent`
+     * for the contract and an example.
+     *
+     * @alpha
+     */
+    ScheduledEmailManagementDialogContextDecoratorComponent?: CustomScheduledEmailManagementDialogContextDecoratorComponent;
     /**
      * Specify component to use for rendering the alerting management dialog.
      *
      * @alpha
      */
     AlertingManagementDialogComponent?: CustomAlertingManagementDialogComponent;
+    /**
+     * Specify component to decorate the data the alerting management dialog reads.
+     *
+     * Rendered between the connector-provided management dialog context and the resolved
+     * management dialog component; see `CustomAlertingManagementDialogContextDecoratorComponent`
+     * for the contract and an example.
+     *
+     * @alpha
+     */
+    AlertingManagementDialogContextDecoratorComponent?: CustomAlertingManagementDialogContextDecoratorComponent;
+    /**
+     * Specify component to decorate the data the automation dialogs' shared context carries.
+     *
+     * Rendered once per dialog tree, directly inside each connector-provided automations context;
+     * see `CustomAutomationsContextDecoratorComponent` for the contract and an example.
+     *
+     * @alpha
+     */
+    AutomationsContextDecoratorComponent?: CustomAutomationsContextDecoratorComponent;
     /**
      * Specify component to use for rendering the alerting dialog.
      *
@@ -11447,9 +11598,10 @@ export declare interface IDashboardExtensionProps extends IDashboardEventing, ID
 
 /**
  * Supported dashboard filter type.
+ *
  * @public
  */
-export declare type IDashboardFilter = IAbsoluteDateFilter | IRelativeDateFilter | IPositiveAttributeFilter | INegativeAttributeFilter | IArbitraryAttributeFilter | IMatchAttributeFilter | IMeasureValueFilter;
+export declare type IDashboardFilter = IDashboardFilter_2;
 
 /**
  * This event is emitted after dashboard selection filters have been reset.
@@ -20828,7 +20980,7 @@ export declare const isDashboardExportToPptPresentationResolved: (obj: unknown)
  *
  * @alpha
  */
-export declare function isDashboardFilter(obj: unknown): obj is IDashboardFilter;
+export declare const isDashboardFilter: typeof isDashboardFilter_2;
 
 /**
  * Tests whether the provided object is an instance of {@link DashboardFilterContextChanged}.
@@ -26474,10 +26626,26 @@ export declare type ScheduledEmailDialogTimezoneDefaultProps = IScheduledEmailDi
 export declare function ScheduledEmailDialogWidgetAttachments(props: Partial<IScheduledEmailDialogWidgetAttachmentsProps>): ReactElement;
 
 /**
+ * Resolves the management dialog component from DashboardComponentsContext and mounts it inside
+ * the resolved context decorator — so a decorated management context is what the dialog (default
+ * or replacement) reads.
+ *
  * @internal
  */
 export declare function ScheduledEmailManagementDialog(props: IScheduledEmailManagementDialogProps): ReactElement;
 
+/**
+ * Provides the scheduled email management dialog context.
+ *
+ * The dashboard's connector mounts the original value. Exported so a context-decorator
+ * component (`CustomScheduledEmailManagementDialogContextDecoratorComponent`) can re-provide a decorated
+ * value read from `useScheduledEmailManagementDialogContext()`; it is not a way to run the management
+ * dialog outside a dashboard.
+ *
+ * @alpha
+ */
+export declare const ScheduledEmailManagementDialogContextProvider: Provider<IScheduledEmailManagementDialogContextValue | undefined>;
+
 /**
  * @internal
  */

package/esm/types.d.ts

@@ -1,17 +1,19 @@
-import { type DrillDefinition, type IAbsoluteDateFilter, type IAccessGrantee, type IArbitraryAttributeFilter, type IAutomationMetadataObject, type IInsight, type IMatchAttributeFilter, type IMeasureValueFilter, type INegativeAttributeFilter, type IPositiveAttributeFilter, type IRelativeDateFilter, type IWidget, type LocalIdRef, type ObjRef, type ShareStatus } from "@gooddata/sdk-model";
+import { type ComponentType, type ReactNode } from "react";
+import { type DrillDefinition, type IAccessGrantee, type IAutomationMetadataObject, type IDashboardFilter as IDashboardFilterBase, type IInsight, type IWidget, type LocalIdRef, type ObjRef, type ShareStatus, isDashboardFilter as isDashboardFilterBase } from "@gooddata/sdk-model";
 import { type IDrillEvent, type OnFiredDrillEvent } from "@gooddata/sdk-ui";
 import { type DateFilterConfigValidationResult } from "./_staging/dateFilterConfig/validation.js";
 /**
  * Supported dashboard filter type.
+ *
  * @public
  */
-export type IDashboardFilter = IAbsoluteDateFilter | IRelativeDateFilter | IPositiveAttributeFilter | INegativeAttributeFilter | IArbitraryAttributeFilter | IMatchAttributeFilter | IMeasureValueFilter;
+export type IDashboardFilter = IDashboardFilterBase;
 /**
  * Type-guard testing whether the provided object is an instance of {@link IDashboardFilter}.
  *
  * @alpha
  */
-export declare function isDashboardFilter(obj: unknown): obj is IDashboardFilter;
+export declare const isDashboardFilter: typeof isDashboardFilterBase;
 /**
  * Supported dashboard drill definitions.
  *
@@ -341,4 +343,58 @@ export interface IAlertDialogContext {
      */
     alert?: IAutomationMetadataObject;
 }
+/**
+ * Decorates the data the automation dialogs' shared context carries.
+ *
+ * The dashboard mounts this component directly inside each connector-provided automations context
+ * — once in the alerting tree and once in the scheduled-email tree — so the value it re-provides
+ * is what everything in both trees reads: the default dialogs, wholesale replacements, exported
+ * blocks and hooks, and the dialogs' state seeding. A decorator must therefore be tree-agnostic.
+ * Read the current value with `useAutomationsContext()`, decorate the members to adjust, and
+ * re-provide via `AutomationsContextProvider`:
+ *
+ * @example
+ * ```tsx
+ * function GranularityDecorator({ children }: { children?: ReactNode }) {
+ *     const ctx = useAutomationsContext();
+ *     const decorated = useMemo(
+ *         () => ({
+ *             ...ctx,
+ *             dateFilterConfig: {
+ *                 ...ctx.dateFilterConfig,
+ *                 availableGranularities: ctx.dateFilterConfig.availableGranularities.filter(
+ *                     (g) => g !== "GDC.time.hour",
+ *                 ),
+ *                 getGranularitiesForTab: (tabId: string) =>
+ *                     ctx.dateFilterConfig
+ *                         .getGranularitiesForTab(tabId)
+ *                         .filter((g) => g !== "GDC.time.hour"),
+ *             },
+ *         }),
+ *         [ctx],
+ *     );
+ *     return <AutomationsContextProvider value={decorated}>{children}</AutomationsContextProvider>;
+ * }
+ * // <Dashboard AutomationsContextDecoratorComponent={GranularityDecorator} />
+ * ```
+ *
+ * To constrain the date-filter granularities the dialogs offer, override
+ * `dateFilterConfig.availableGranularities` and `dateFilterConfig.getGranularitiesForTab`
+ * together, as above — the date filter falls back per tab. Components that build this context
+ * themselves (the standalone connected dialogs, the widget-panel alerts list) are not decorated.
+ * Define the decorator outside render, or both dialog trees remount on every parent render.
+ * Both instances mount with the dashboard, not only while a dialog is open — a decorator that
+ * fetches data runs on every dashboard.
+ *
+ * The contract: change the data, not what it means — every member keeps its documented meaning.
+ * The dialog does not check the decorated value; when you override a member, everything that
+ * reads it is your responsibility. Spread the value you read (`{ ...ctx, member }`) so the other
+ * members pass through. Wrap functions instead of replacing them. Do not touch members marked as
+ * internal machinery.
+ *
+ * @alpha
+ */
+export type CustomAutomationsContextDecoratorComponent = ComponentType<{
+    children?: ReactNode;
+}>;
 //# sourceMappingURL=types.d.ts.map