@sisense/sdk-ui 2.22.0 → 2.24.0

package/dist/packages/sdk-ui/src/domains/dashboarding/components/editable-layout/const.d.ts

@@ -1,3 +1,4 @@
+export declare const DRAG_ACTIVATION_DISTANCE_PX = 5;
 export declare const RESIZE_LINE_SIZE = 4;
 export declare const MIN_ROW_HEIGHT = 60;
 export declare const MAX_ROW_HEIGHT = 1500;

package/dist/packages/sdk-ui/src/domains/dashboarding/components/editable-layout/smart-pointer-sensor.d.ts

@@ -0,0 +1,17 @@
+import type { PointerEvent } from 'react';
+import { PointerSensor } from '@dnd-kit/core';
+import type { PointerSensorOptions } from '@dnd-kit/core';
+/**
+ * PointerSensor that skips activation when the event originates from interactive
+ * elements (input, textarea, select, button, contenteditable) or elements
+ * explicitly marked with the `data-no-dnd` attribute.
+ * Prevents DnD from stealing focus and keyboard events from the widget title editor.
+ *
+ * @internal
+ */
+export declare class SmartPointerSensor extends PointerSensor {
+    static activators: {
+        eventName: "onPointerDown";
+        handler: ({ nativeEvent: event }: PointerEvent, { onActivation }: PointerSensorOptions) => boolean;
+    }[];
+}

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/get-dashboard-model.d.ts

@@ -40,6 +40,7 @@ export interface GetDashboardModelOptions {
  * @param themeSettings - Optional theme settings
  * @param appSettings - Optional application settings
  * @returns The dashboard model
- * @internal
+ *
+ * @internal @sisenseInternal
  */
 export declare function getDashboardModel(http: HttpClient, dashboardOid: string, options?: GetDashboardModelOptions, themeSettings?: CompleteThemeSettings, appSettings?: AppSettings): Promise<DashboardModel>;

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/use-dashboard-model/dashboard-model-reducer/types.d.ts

@@ -14,14 +14,24 @@ export declare enum UseDashboardModelActionTypeInternal {
 /**
  * Action types for the dashboard model state used in {@link useDashboardModel}.
  *
- * @internal
+ * @sisenseInternal
  */
 export declare enum UseDashboardModelActionType {
     FILTERS_UPDATE = "FILTERS.UPDATE",
     ADD_WIDGET = "WIDGETS.ADD",
+    PATCH_WIDGET = "WIDGETS.PATCH",
     WIDGETS_PANEL_LAYOUT_UPDATE = "WIDGETS_PANEL_LAYOUT.UPDATE",
     WIDGETS_DELETE = "WIDGETS.DELETE"
 }
+/**
+ * Fields that can be safely patched on a widget without full DTO reconstruction.
+ * Intentionally narrow — extend only when lossless roundtrip is guaranteed.
+ *
+ * @internal
+ */
+export type WidgetPatch = {
+    title?: string;
+};
 /**
  * Internal actions for the dashboard model state used in {@link useDashboardModel}.
  *
@@ -42,7 +52,7 @@ export type UseDashboardModelInternalAction = UseDashboardModelAction | {
  *
  * @internal
  */
-export type UseDashboardModelAction = UseDashboardModelFilterUpdateAction | UseDashboardModelAddWidgetAction | UseDashboardModelLayoutUpdateAction | UseDashboardWidgetsDeleteAction;
+export type UseDashboardModelAction = UseDashboardModelFilterUpdateAction | UseDashboardModelAddWidgetAction | UseDashboardModelPatchWidgetAction | UseDashboardModelLayoutUpdateAction | UseDashboardWidgetsDeleteAction;
 /**
  * Filter update actions for the dashboard model state used in {@link useDashboardModel}.
  *
@@ -72,6 +82,18 @@ export type UseDashboardModelAddWidgetAction = {
         widgetOptions?: SpecificWidgetOptions;
     };
 };
+/**
+ * Patch widget action for the dashboard model state used in {@link useDashboardModel}.
+ *
+ * @internal
+ */
+export type UseDashboardModelPatchWidgetAction = {
+    type: UseDashboardModelActionType.PATCH_WIDGET;
+    payload: {
+        widgetOid: string;
+        patch: WidgetPatch;
+    };
+};
 /**
  * Layout update action for the dashboard model state used in {@link useDashboardModel}.
  *

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/use-dashboard-model/dashboard-model-reducer/utils.d.ts

@@ -7,7 +7,8 @@ import { AddWidgetPayload } from './types.js';
  *
  * @param filtersOrFilterRelations - The filters or filter relations to translate
  * @returns The translated filters and relations DTOs for Fusion
- * @internal
+ *
+ * @sisenseInternal
  */
 export declare function translateFiltersAndRelationsToDto(filtersOrFilterRelations: Filter[] | FilterRelations): {
     filters: (import("../../../../../infra/api/types/dashboard-dto.js").FilterDto | import("../../../../../infra/api/types/dashboard-dto.js").CascadingFilterDto)[];

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/use-dashboard-model/use-dashboard-persistence.d.ts

@@ -36,6 +36,7 @@ export interface UseDashboardPersistenceResult {
  *
  * @param params - Parameters for dashboard persistence
  * @returns Dashboard persistence state and dispatch function
- * @internal
+ *
+ * @sisenseInternal
  */
 export declare function useDashboardPersistence({ dashboard, persist, sharedMode, }: UseDashboardPersistenceParams): UseDashboardPersistenceResult;

package/dist/packages/sdk-ui/src/domains/dashboarding/hooks/jtd/jtd-types.d.ts

@@ -200,7 +200,7 @@ export interface JumpToDashboardConfigForPivot extends Omit<JumpToDashboardConfi
     /**
      * Map of target dashboards for different dimensions/measures
      *
-     * @alpha
+     * @beta
      * @example
      *
      * const FormulaMeasure = dashboardProps.widgets[0].dataOptions.values[0];

package/dist/packages/sdk-ui/src/domains/dashboarding/hooks/rename-widget/use-widget-renaming.d.ts

@@ -0,0 +1,34 @@
+import type { WidgetProps } from '../../../../domains/widgets/components/widget/types.js';
+import type { DashboardPersistenceManager } from '../../types.js';
+/** Options for the widget renaming middleware hook. */
+export type UseWidgetRenamingParams = {
+    /** Current widgets. */
+    widgets: WidgetProps[];
+    /** When false, returns widgets unchanged (no config.header.title.editing.enabled, no persistence wrap). */
+    enabled?: boolean;
+    /** When provided, persists widget renames to the server on title/changed. */
+    persistence?: Pick<DashboardPersistenceManager, 'patchWidget'>;
+};
+/** Output of the widget renaming middleware. */
+export type WidgetRenamingOutput = {
+    widgets: WidgetProps[];
+};
+/**
+ * Middleware hook that enables widget-level rename UI and optionally persists renames.
+ * Sets config.header.title.editing.enabled on each widget so ChartWidget/PivotTableWidget show rename UI.
+ * When persistence is set, wraps widget onChange to call patchWidget on title/changed
+ * before forwarding to the change-detection layer.
+ *
+ * @param options - Options containing widgets, enabled flag, and optional persistence.
+ * @returns Widgets with config.header.title.editing.enabled and optionally wrapped onChange.
+ *
+ * @example
+ * ```ts
+ * const { widgets: widgetsWithRename } = useWidgetRenaming({
+ *   widgets: widgetsWithDuplicate,
+ *   enabled: true,
+ *   persistence,
+ * });
+ * ```
+ */
+export declare function useWidgetRenaming(params: UseWidgetRenamingParams): WidgetRenamingOutput;

package/dist/packages/sdk-ui/src/domains/dashboarding/hooks/use-widget-csv-download.d.ts

@@ -0,0 +1,24 @@
+import type { WidgetProps } from '../../../domains/widgets/components/widget/types.js';
+export type UseWidgetCsvDownloadParams = {
+    widgets: WidgetProps[];
+    /**
+     * CSV download enabled value from `config.widgetsPanel.actions.downloadCsv.enabled`.
+     * Per-widget `config.actions.downloadCsv.enabled` overrides when explicitly set.
+     */
+    enabled: boolean;
+};
+/**
+ * Applies dashboard-level CSV download settings to each widget's `config`.
+ *
+ * Reads `config.widgetsPanel.actions.downloadCsv.enabled` and merges it into
+ * `widget.config.actions.downloadCsv` for every widget.
+ * Widget-level `config.actions.downloadCsv.enabled` takes precedence when defined, so the dashboard-level config acts as a
+ * default rather than replacing explicit widget configuration.
+ *
+ * @param params - Widgets and panel-level CSV toggle
+ * @returns Widgets with resolved `config.actions.downloadCsv.enabled`
+ * @internal
+ */
+export declare function useWidgetCsvDownload({ widgets, enabled }: UseWidgetCsvDownloadParams): {
+    widgets: WidgetProps[];
+};

package/dist/packages/sdk-ui/src/domains/dashboarding/types.d.ts

@@ -1,6 +1,6 @@
 import { ReactNode } from 'react';
 import { DataSource, Filter, FilterRelations } from '@sisense/sdk-data';
-import { DashboardStyleOptions, SpecificWidgetOptions, WidgetsOptions, WidgetsPanelLayout } from '../../domains/dashboarding/dashboard-model';
+import { DashboardStyleOptions, SpecificWidgetOptions, WidgetPatch, WidgetsOptions, WidgetsPanelLayout } from '../../domains/dashboarding/dashboard-model';
 import { TabbersConfig } from '../../domains/dashboarding/hooks/use-tabber';
 import { FiltersPanelConfig } from '../../domains/filters/components/filters-panel/types';
 import { WidgetProps } from '../../domains/widgets/components/widget/types';
@@ -161,6 +161,26 @@ export interface WidgetsPanelConfig {
      * Edit mode configuration.
      */
     editMode?: EditModeConfig;
+    /**
+     * Actions available for all widgets in the panel.
+     *
+     * @sisenseInternal
+     */
+    actions?: {
+        /**
+         * Configuration for downloading a widget CSV.
+         *
+         * @sisenseInternal
+         */
+        downloadCsv?: {
+            /**
+             * Determines whether the widgets possibility to download a CSV is enabled.
+             *
+             * If not specified, the default value is `false`.
+             */
+            enabled?: boolean;
+        };
+    };
 }
 /**
  * Edit mode configuration
@@ -234,6 +254,22 @@ export interface EditModeConfig {
          */
         enabled: boolean;
     };
+    /**
+     * Configuration for the widget renaming feature.
+     *
+     * @internal
+     */
+    renameWidget?: {
+        /**
+         * When `true`, adds a "Rename widget" menu item to each widget header.
+         * On click, triggers inline title editing of the widget.
+         * Only has effect when edit mode is also enabled (`editMode.enabled`).
+         *
+         * If not specified, the default value is `false`.
+         * @internal
+         */
+        enabled: boolean;
+    };
 }
 /**
  * Dashboard configuration
@@ -314,6 +350,12 @@ export type DashboardPersistenceManager = {
         widgetsPanelLayout: WidgetsPanelLayout;
         widgetOptions?: SpecificWidgetOptions;
     }>;
+    /**
+     * Patch a single field (e.g. title) on an existing widget.
+     *
+     * @internal
+     */
+    patchWidget: (widgetOid: string, patch: WidgetPatch) => Promise<void>;
 };
 /**
  * Props for the Dashboard component

package/dist/packages/sdk-ui/src/domains/dashboarding/use-dashboard-theme.d.ts

@@ -34,8 +34,8 @@ export declare const useDashboardThemeInternal: ({ styleOptions }: DashboardThem
  * React hook that returns dashboard theme settings
  *
  * @group Dashboards
+ *
  * @alpha
- * @internal
  */
 export declare const useDashboardTheme: (args_0: DashboardThemeParams) => {
     themeSettings: {

package/dist/packages/sdk-ui/src/domains/data-browser/add-filter-popover/add-filter-data-browser.d.ts

@@ -1,4 +1,4 @@
-import { DataSource } from '@sisense/sdk-data';
+import { DataSource, DataSourceField, Dimension } from '@sisense/sdk-data';
 import { AttributiveElement } from '../dimensions-browser/types.js';
 type AddFilterDataBrowserProps = {
     dataSources: DataSource[];
@@ -13,4 +13,5 @@ type AddFilterDataBrowserProps = {
  * A component that allows users to select a data source and an attribute to create a filter.
  */
 export declare const AddFilterDataBrowser: ({ initialDataSource, dataSources, disabledAttributes, onAttributeClick, }: AddFilterDataBrowserProps) => import("react/jsx-runtime").JSX.Element;
+export declare const useGetDimensionsFromDataSourceFields: (dataSourceFields: DataSourceField[] | undefined, dataSource: DataSource) => Dimension[];
 export {};

package/dist/packages/sdk-ui/src/domains/data-browser/data-schema-browser/data-schema-browser.d.ts

@@ -8,7 +8,8 @@ type DataSchemaBrowserProps = {
  *
  * @param params DataSchemaBrowserProps
  * @returns ReactElement
- * @internal
+ *
+ * @sisenseInternal
  */
 export declare const DataSchemaBrowser: ({ dimensions, collapseAll }: DataSchemaBrowserProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/packages/sdk-ui/src/domains/data-browser/dimensions-browser/types.d.ts

@@ -54,6 +54,7 @@ export type AttributiveElement = Attribute | DateDimension;
  */
 export type AttributeActionConfig = {
     onClick(this: void, attribute: AttributiveElement): void;
+    getLabel?: (this: void, attribute: AttributiveElement) => string;
 };
 /**
  * Config for secondary action to be performed on an attribute.
@@ -65,10 +66,17 @@ export type AttributeSecondaryActionConfig = {
     SecondaryActionButtonIcon: React.ComponentType<{
         attribute: AttributiveElement;
     }>;
+    /**
+     * When true, the row keeps hover/focus style after the secondary action is clicked (e.g. while a menu is open).
+     * Call the `onSubmit` callback passed to `onClick` to clear the focus (e.g. when the menu closes).
+     */
+    keepFocusedOnClick?: boolean;
     /**
      * Callback to be executed when the secondary action button is clicked.
+     * The optional event provides the click position for positioning menus.
+     * When keepFocusedOnClick is true, `onSubmit` is provided; call it to clear the focused state (e.g. in menu onClose).
      */
-    onClick(this: void, attribute: AttributiveElement): void;
+    onClick(this: void, attribute: AttributiveElement, event: React.MouseEvent, onSubmit: () => void): void;
 };
 /**
  * Config for secondary action to be performed on a dimension.

package/dist/packages/sdk-ui/src/domains/formulas/fetch-formula.d.ts

@@ -1,5 +1,5 @@
 import { DataSource, DimensionalCalculatedMeasure } from '@sisense/sdk-data';
-import { ClientApplication } from '../../infra/app/client-application';
+import { type ClientApplication } from '../../infra/app/types';
 /**
  * Fetch a formula by oid from the default Sisense instance
  *

package/dist/packages/sdk-ui/src/domains/query-execution/core/execute-query.d.ts

@@ -1,7 +1,7 @@
 import { Attribute, DataSource, Measure, PivotAttribute, PivotMeasure, PivotQueryResultData, QueryResultData } from '@sisense/sdk-data';
 import type { PivotQueryDescription as InternalPivotQueryDescription, QueryDescription as InternalQueryDescription, QueryExecutionConfig } from '@sisense/sdk-query-client';
 import { CreateCacheKeyFn } from '../../../shared/utils/create-cache';
-import { ClientApplication } from '../../../infra/app/client-application.js';
+import { type ClientApplication } from '../../../infra/app/types.js';
 /**
  * All the properties that fully describe a query you want to send.
  *

package/dist/packages/sdk-ui/src/domains/query-execution/hooks/use-execute-query-by-widget-id/use-execute-query-by-widget-id.d.ts

@@ -1,5 +1,5 @@
 import { QueryResultData } from '@sisense/sdk-data';
-import { ClientApplication } from '../../../../infra/app/client-application';
+import { type ClientApplication } from '../../../../infra/app/types';
 import { ExecuteQueryByWidgetIdParams, QueryByWidgetIdQueryParams, QueryByWidgetIdState } from '../../types';
 /**
  * React hook that executes a data query extracted from an existing widget in the Sisense instance.

package/dist/packages/sdk-ui/src/domains/query-execution/hooks/use-query-cache/use-query-cache.d.ts

@@ -5,7 +5,8 @@
  *
  * @returns QueryCacheClient instance
  * @group Queries
- * @alpha
+ *
+ * @beta
  */
 export declare function useQueryCache(): {
     clear: () => void;

package/dist/packages/sdk-ui/src/domains/visualizations/components/boxplot-chart/boxplot-utils.d.ts

@@ -1,5 +1,5 @@
 import { Attribute, DataSource, Filter, FilterRelationsJaql, Measure, QueryResultData } from '@sisense/sdk-data';
-import { ClientApplication } from '../../../../infra/app/client-application.js';
+import { type ClientApplication } from '../../../../infra/app/types.js';
 import { executeQuery as executeQueryFunction } from '../../../query-execution/core/execute-query.js';
 import { BoxplotChartCustomDataOptions, BoxplotChartDataOptionsInternal } from '../../core/chart-data-options/types.js';
 /**

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/helpers/get-load-data-function.d.ts

@@ -1,7 +1,7 @@
 import { QueryResultData } from '@sisense/sdk-data';
 import { QueryExecutionConfig } from '@sisense/sdk-query-client';
 import { QueryDescription } from '../../../../../domains/query-execution/core/execute-query';
-import { ClientApplication } from '../../../../../infra/app/client-application';
+import { type ClientApplication } from '../../../../../infra/app/types';
 import { ChartType } from '../../../../../types';
 import { ChartDataOptionsInternal } from '../../../core/chart-data-options/types';
 export type LoadDataFunction = (options: {

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/helpers/use-translated-data-options.d.ts

@@ -1,5 +1,16 @@
 import { ChartDataOptions, ChartType } from '../../../../../types';
-export declare const useTranslatedDataOptions: (chartDataOptions: ChartDataOptions, chartType: ChartType, isForecastOrTrendChart: boolean) => {
+export declare const useTranslatedDataOptions: (chartDataOptions: ChartDataOptions, chartType: ChartType, isForecastOrTrendChart?: boolean) => {
+    dataOptions: import("../../../core/chart-data-options/types.js").ChartDataOptionsInternal;
+    attributes: import("@sisense/sdk-data").Attribute[];
+    measures: import("@sisense/sdk-data").Measure[];
+    dataColumnNamesMapping: import('../../../../../domains/visualizations/core/chart-data-options/validate-data-options/index.js').DataColumnNamesMapping;
+};
+export declare function getTranslatedDataOptions(chartDataOptions: ChartDataOptions, chartType: ChartType, options?: {
+    /** Indicates if the chart is a forecast or trend chart for temporal routing between legacy and restructured charts processing */
+    isForecastOrTrendChart?: boolean;
+    /** Indicates if the data column names should be generated uniquely */
+    shouldHaveUniqueDataColumnNames?: boolean;
+}): {
     dataOptions: import("../../../core/chart-data-options/types.js").ChartDataOptionsInternal;
     attributes: import("@sisense/sdk-data").Attribute[];
     measures: import("@sisense/sdk-data").Measure[];

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/helpers/data-loading.d.ts

@@ -1,7 +1,7 @@
 import { QueryResultData } from '@sisense/sdk-data';
 import { QueryExecutionConfig } from '@sisense/sdk-query-client';
 import { QueryDescription } from '../../../../../../domains/query-execution/core/execute-query';
-import { ClientApplication } from '../../../../../../infra/app/client-application';
+import { type ClientApplication } from '../../../../../../infra/app/types.js';
 /**
  * Load data by a regular single query execution.
  */

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/types.d.ts

@@ -10,7 +10,7 @@ import { AreamapChartDataOptions, AreamapChartDataOptionsInternal, CalendarHeatm
 import { DataTable } from '../../../../../domains/visualizations/core/chart-data-processor/table-processor';
 import type { CartesianChartData, CategoricalChartData, ScattermapChartData } from '../../../../../domains/visualizations/core/chart-data/types';
 import { DesignOptions } from '../../../../../domains/visualizations/core/chart-options-processor/translations/types';
-import { ClientApplication } from '../../../../../infra/app/client-application';
+import { type ClientApplication } from '../../../../../infra/app/types';
 import type { AreamapStyleOptions, AreaStyleOptions, CalendarHeatmapStyleOptions, ChartDataOptions, ChartStyleOptions, FunnelStyleOptions, LineStyleOptions, PieStyleOptions, PolarStyleOptions, ScattermapStyleOptions, StackableStyleOptions, StreamgraphStyleOptions, SunburstStyleOptions, TreemapStyleOptions } from '../../../../../types';
 import { AreamapData } from './areamap-chart/types';
 import { CalendarHeatmapChartData } from './highchart-based-charts/calendar-heatmap-chart/data';

package/dist/packages/sdk-ui/src/domains/widgets/change-events.d.ts

@@ -0,0 +1,73 @@
+import { Attribute } from '@sisense/sdk-data';
+import { DataOptionLocation, DrilldownSelection } from '../../types';
+/**
+ * Event triggered when chart widget drilldown selections change.
+ *
+ * @example
+ * ```ts
+ * { type: 'drilldownSelections/changed', payload: [{ points: [...], nextDimension }] }
+ * ```
+ */
+export interface ChartWidgetDrilldownSelectionsChangedEvent {
+    /** Event type */
+    type: 'drilldownSelections/changed';
+    /** The new drilldown selections */
+    payload: DrilldownSelection[];
+}
+/**
+ * Event triggered when widget title changes (e.g. inline rename).
+ *
+ * @example
+ * ```ts
+ * { type: 'title/changed', payload: { title: 'New Title' } }
+ * ```
+ */
+export interface WidgetTitleChangedEvent {
+    /** Event type */
+    type: 'title/changed';
+    /** The new title */
+    payload: {
+        title: string;
+    };
+}
+/**
+ * Events that can be triggered by the ChartWidget component.
+ */
+export type ChartWidgetChangeEvent = ChartWidgetDrilldownSelectionsChangedEvent | WidgetTitleChangedEvent;
+/**
+ * Event triggered when pivot table widget drilldown selections change.
+ *
+ * @example
+ * ```ts
+ * { type: 'drilldownSelections/changed', payload: { target, selections } }
+ * ```
+ */
+export interface PivotTableWidgetDrilldownSelectionsChangedEvent {
+    /** Event type */
+    type: 'drilldownSelections/changed';
+    /** The drilldown target and new selections */
+    payload: {
+        target: Attribute | DataOptionLocation;
+        selections: DrilldownSelection[];
+    };
+}
+/**
+ * Events that can be triggered by the PivotTableWidget component.
+ */
+export type PivotTableWidgetChangeEvent = PivotTableWidgetDrilldownSelectionsChangedEvent | WidgetTitleChangedEvent;
+/**
+ * Events that can be triggered by widget components.
+ *
+ * Union of all widget-specific change events. Extensible for TextWidget, CustomWidget future events.
+ *
+ * @example
+ * ```ts
+ * ChartWidget onChange handler:
+ * onChange={(event) => {
+ *   if (event.type === 'drilldownSelections/changed') {
+ *     setDrilldownSelections(event.payload);
+ *   }
+ * }}
+ * ```
+ */
+export type WidgetChangeEvent = ChartWidgetChangeEvent | PivotTableWidgetChangeEvent;

package/dist/packages/sdk-ui/src/domains/widgets/components/chart-widget/types.d.ts

@@ -1,8 +1,10 @@
 import { ReactNode } from 'react';
 import { DataSource, Filter, FilterRelations } from '@sisense/sdk-data';
+import type { ChartWidgetChangeEvent, ChartWidgetDrilldownSelectionsChangedEvent } from '../../../../domains/widgets/change-events';
 import type { ChartEventProps } from '../../../../props';
 import { ChartDataOptions, ChartType, ChartWidgetStyleOptions, DrilldownOptions } from '../../../../types';
 import { WidgetConfig } from '../widget/types';
+export type { ChartWidgetChangeEvent, ChartWidgetDrilldownSelectionsChangedEvent };
 /**
  * Props for the {@link ChartWidget} component
  *
@@ -95,6 +97,14 @@ export interface ChartWidgetProps extends ChartEventProps {
      * @category Widget
      */
     highlightSelectionDisabled?: boolean;
-    /** @internal */
-    onChange?: (props: Partial<ChartWidgetProps>) => void;
+    /**
+     * Callback to receive widget change events.
+     *
+     * Invoked when the widget state changes (e.g. drilldown selections).
+     * See {@link ChartWidgetChangeEvent} for event types.
+     *
+     * @param event - The change event that occurred
+     * @internal
+     */
+    onChange?: (event: ChartWidgetChangeEvent) => void;
 }

package/dist/packages/sdk-ui/src/domains/widgets/components/chart-widget/use-chart-widget-csv-download.d.ts

@@ -0,0 +1,18 @@
+import type { WidgetHeaderConfig } from '../../../../domains/widgets/shared/widget-header/types.js';
+import type { ChartWidgetProps } from './types.js';
+export type UseChartWidgetCsvDownloadParams = Pick<ChartWidgetProps, 'title' | 'dataOptions' | 'chartType' | 'filters' | 'highlights' | 'config' | 'dataSource'> & {
+    /** Base header config */
+    baseHeaderConfig: WidgetHeaderConfig;
+};
+export type UseChartWidgetCsvDownloadResult = {
+    headerConfig: WidgetHeaderConfig;
+};
+/**
+ * Enhances a chart widget's header with CSV download capabilities:
+ * - Adds the "Download > CSV File" header menu item.
+ * - Executes the CSV query and downloads the result as a CSV file.
+ *
+ * @param props - Chart widget props and base header config
+ * @returns Header config for {@link WidgetContainer}
+ */
+export declare function useChartWidgetCsvDownload(props: UseChartWidgetCsvDownloadParams): UseChartWidgetCsvDownloadResult;

package/dist/packages/sdk-ui/src/domains/widgets/components/custom-widget/use-custom-widget-csv-download.d.ts

@@ -0,0 +1,15 @@
+import type { WidgetHeaderConfig } from '../../../../domains/widgets/shared/widget-header/types.js';
+import type { CustomWidgetProps } from './types.js';
+export type UseCustomWidgetCsvDownloadParams = Pick<CustomWidgetProps, 'title' | 'dataOptions' | 'filters' | 'highlights' | 'config' | 'dataSource'>;
+export type UseCustomWidgetCsvDownloadResult = {
+    headerConfig: WidgetHeaderConfig;
+};
+/**
+ * Enhances a custom widget's header with CSV download capabilities:
+ * - Adds the "Download > CSV File" header menu item.
+ * - Executes the CSV query and downloads the result as a CSV file.
+ *
+ * @param widgetProps - Custom widget props needed for CSV
+ * @returns Header config for {@link WidgetContainer}
+ */
+export declare function useCustomWidgetCsvDownload(widgetProps: UseCustomWidgetCsvDownloadParams): UseCustomWidgetCsvDownloadResult;

package/dist/packages/sdk-ui/src/domains/widgets/components/pivot-table-widget/types.d.ts

@@ -2,9 +2,11 @@ import { ReactNode } from 'react';
 import { DataSource, Filter, FilterRelations } from '@sisense/sdk-data';
 import type { CustomDataCellFormatter, CustomHeaderCellFormatter } from '../../../../domains/visualizations/components/pivot-table/formatters/types';
 import { PivotTableDataOptions } from '../../../../domains/visualizations/core/chart-data-options/types';
+import type { PivotTableWidgetChangeEvent, PivotTableWidgetDrilldownSelectionsChangedEvent } from '../../../../domains/widgets/change-events';
 import type { PivotTableDataPointEventHandler } from '../../../../props';
 import { PivotTableDrilldownOptions, PivotTableWidgetStyleOptions } from '../../../../types';
 import { WidgetConfig } from '../widget/types';
+export type { PivotTableWidgetChangeEvent, PivotTableWidgetDrilldownSelectionsChangedEvent };
 /**
  * Props for the {@link PivotTableWidget} component
  */
@@ -136,6 +138,14 @@ export interface PivotTableWidgetProps {
      * @internal
      */
     onHeaderCellFormat?: CustomHeaderCellFormatter;
-    /** @internal */
-    onChange?: (props: Partial<PivotTableWidgetProps>) => void;
+    /**
+     * Callback to receive widget change events.
+     *
+     * Invoked when the widget state changes (e.g. drilldown selections).
+     * See {@link PivotTableWidgetChangeEvent} for event types.
+     *
+     * @param event - The change event that occurred
+     * @internal
+     */
+    onChange?: (event: PivotTableWidgetChangeEvent) => void;
 }

package/dist/packages/sdk-ui/src/domains/widgets/components/pivot-table-widget/use-pivot-widget-csv-download.d.ts

@@ -0,0 +1,18 @@
+import type { WidgetHeaderConfig } from '../../../../domains/widgets/shared/widget-header/types.js';
+import type { PivotTableWidgetProps } from './types.js';
+export type UsePivotWidgetCsvDownloadParams = Pick<PivotTableWidgetProps, 'title' | 'dataOptions' | 'filters' | 'highlights' | 'config' | 'dataSource'> & {
+    /** Header config from {@link useWidgetHeaderManagement} (rename menu, etc.). */
+    baseHeaderConfig: WidgetHeaderConfig;
+};
+export type UsePivotWidgetCsvDownloadResult = {
+    headerConfig: WidgetHeaderConfig;
+};
+/**
+ * Enhances a pivot table widget's header with CSV download capabilities:
+ * - Adds the "Download > CSV File" header menu item.
+ * - Executes the CSV query and downloads the result as a CSV file.
+ *
+ * @param props - Pivot widget props and base header config
+ * @returns Header config for {@link WidgetContainer}
+ */
+export declare function usePivotWidgetCsvDownload(props: UsePivotWidgetCsvDownloadParams): UsePivotWidgetCsvDownloadResult;

package/dist/packages/sdk-ui/src/domains/widgets/components/tabber-buttons-widget/types.d.ts

@@ -4,10 +4,6 @@ import { CustomWidgetProps } from '../../../../domains/widgets/components/custom
  *
  */
 export type TabberButtonsWidgetStyleOptions = {
-    /**
-     * Color of the widget description text
-     */
-    descriptionColor?: string;
     /**
      * Background color of the selected tab
      */
@@ -22,6 +18,14 @@ export type TabberButtonsWidgetStyleOptions = {
      * @defaultValue true
      */
     showDescription?: boolean;
+    /**
+     * Description text displayed in the tabber widget (when showDescription is true)
+     */
+    description?: string;
+    /**
+     * Color of the widget description text
+     */
+    descriptionColor?: string;
     /**
      * Whether to show visual separators between tabs
      *
@@ -120,8 +124,4 @@ export interface TabberButtonsWidgetProps extends CustomWidgetProps {
      * Configuration for tabs including names and active tab index
      */
     customOptions: TabberButtonsWidgetCustomOptions;
-    /**
-     * Description text displayed in the widget
-     */
-    description?: string;
 }