@sisense/sdk-ui 2.27.0 → 2.29.0

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/translations/pie-series.d.ts

@@ -1,5 +1,5 @@
 import { SeriesPieOptions } from '@sisense/sisense-charts';
-import { CompleteThemeSettings, Convolution, SeriesWithAlerts } from '../../../../../types';
+import { CompleteThemeSettingsInternal, Convolution, SeriesWithAlerts } from '../../../../../types';
 import { CategoricalChartDataOptionsInternal } from '../../chart-data-options/types';
 import { CategoricalChartData } from '../../chart-data/types';
 import { SeriesType } from '../chart-options-service';
@@ -20,7 +20,7 @@ export declare const getPieSeries: ({ chartData, dataOptions, seriesCapacity, co
     dataOptions: CategoricalChartDataOptionsInternal;
     seriesCapacity: number;
     convolution?: Convolution | undefined;
-    themeSettings?: CompleteThemeSettings | undefined;
+    themeSettings?: CompleteThemeSettingsInternal | undefined;
 }) => SeriesType[];
 /**
  * Returns only the convolution series (breakdown of "Others" slice).
@@ -31,7 +31,7 @@ export declare const getPieConvolutionSeries: ({ chartData, dataOptions, seriesC
     dataOptions: CategoricalChartDataOptionsInternal;
     seriesCapacity: number;
     convolution?: Convolution | undefined;
-    themeSettings?: CompleteThemeSettings | undefined;
+    themeSettings?: CompleteThemeSettingsInternal | undefined;
 }) => SeriesPieOptions[];
 /**
  * Convert categorical chart data into renderable highcharts pie series.
@@ -42,5 +42,5 @@ export declare const getPieConvolutionSeries: ({ chartData, dataOptions, seriesC
  * @param themeSettings - Theme configuration for colors and styling
  * @returns Formatted pie chart data with series, alerts, and convolution series
  */
-export declare const formatCategoricalChartData: (chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: PieChartDesignOptions, themeSettings?: CompleteThemeSettings) => FormattedPieChartData;
+export declare const formatCategoricalChartData: (chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: PieChartDesignOptions, themeSettings?: CompleteThemeSettingsInternal) => FormattedPieChartData;
 export {};

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/translations/scatter-series.d.ts

@@ -1,4 +1,4 @@
-import { CompleteThemeSettings, SeriesWithAlerts } from '../../../../../types';
+import { CompleteThemeSettingsInternal, SeriesWithAlerts } from '../../../../../types';
 import { ScatterChartDataOptionsInternal } from '../../chart-data-options/types';
 import { ComparableData } from '../../chart-data-processor/table-processor';
 import { ScatterAxisCategoriesMap, ScatterDataTable } from '../../chart-data/types';
@@ -22,4 +22,4 @@ export interface AxisComputedProperties {
     selected?: boolean;
 }
 export declare const handleNumberValue: (cell: ComparableData) => number | null;
-export declare const buildScatterSeries: (data: ScatterDataTable, categoriesMap: ScatterAxisCategoriesMap, dataOptions?: ScatterChartDataOptionsInternal, designOptions?: ChartDesignOptions, themeSettings?: CompleteThemeSettings, seriesCapacity?: number) => SeriesWithAlerts<SeriesType[]>;
+export declare const buildScatterSeries: (data: ScatterDataTable, categoriesMap: ScatterAxisCategoriesMap, dataOptions?: ScatterChartDataOptionsInternal, designOptions?: ChartDesignOptions, themeSettings?: CompleteThemeSettingsInternal, seriesCapacity?: number) => SeriesWithAlerts<SeriesType[]>;

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/translations/sunburst/sunburst-levels.d.ts

@@ -1,9 +1,9 @@
 import { PointLabelObject } from '@sisense/sisense-charts';
-import { CompleteThemeSettings } from '../../../../../../types';
+import { CompleteThemeSettingsInternal } from '../../../../../../types';
 import { CategoricalChartDataOptionsInternal } from '../../../chart-data-options/types';
 import { CategoricalChartData } from '../../../chart-data/types';
 import { SunburstChartDesignOptions } from '../design-options';
-export declare function prepareSunburstLevels(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: SunburstChartDesignOptions, themeSettings?: CompleteThemeSettings): ({
+export declare function prepareSunburstLevels(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: SunburstChartDesignOptions, themeSettings?: CompleteThemeSettingsInternal): ({
     level: number;
     color: string;
     dataLabels: {

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/translations/sunburst/sunburst-options.d.ts

@@ -1,5 +1,5 @@
 import { TFunction } from '@sisense/sdk-common';
-import { CompleteThemeSettings } from '../../../../../../types';
+import { CompleteThemeSettingsInternal } from '../../../../../../types';
 import { CategoricalChartDataOptionsInternal } from '../../../chart-data-options/types';
 import { CategoricalChartData } from '../../../chart-data/types';
 import { HighchartsOptionsInternal } from '../../chart-options-service';
@@ -7,7 +7,7 @@ import { SunburstChartDesignOptions } from '../design-options';
 /**
  * Prepares the series configuration for sunburst chart
  */
-export declare function prepareSunburstSeries(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: SunburstChartDesignOptions, themeSettings?: CompleteThemeSettings): ({
+export declare function prepareSunburstSeries(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: SunburstChartDesignOptions, themeSettings?: CompleteThemeSettingsInternal): ({
     name: string;
     showInLegend: boolean;
     color: string;
@@ -108,4 +108,4 @@ export declare function prepareSunburstSeries(chartData: CategoricalChartData, d
  * Prepares the tooltip configuration for sunburst chart
  */
 export declare function prepareSunburstTooltip(dataOptions: CategoricalChartDataOptionsInternal, designOptions: SunburstChartDesignOptions, translate: TFunction): import("../tooltip-utils").TooltipSettings;
-export declare function prepareSunburstOptions(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: SunburstChartDesignOptions, translate: TFunction, themeSettings?: CompleteThemeSettings): HighchartsOptionsInternal;
+export declare function prepareSunburstOptions(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: SunburstChartDesignOptions, translate: TFunction, themeSettings?: CompleteThemeSettingsInternal): HighchartsOptionsInternal;

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/translations/sunburst/sunburst-series.d.ts

@@ -1,8 +1,8 @@
-import { CompleteThemeSettings } from '../../../../../../types';
+import { CompleteThemeSettingsInternal } from '../../../../../../types';
 import { CategoricalChartDataOptionsInternal } from '../../../chart-data-options/types';
 import { CategoricalChartData } from '../../../chart-data/types';
 export declare const SUNBURST_ROOT_PARENT_ID = "SUNBURST_ROOT_PARENT_ID";
-export declare function prepareSunburstDataItems(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, themeSettings?: CompleteThemeSettings): ({
+export declare function prepareSunburstDataItems(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, themeSettings?: CompleteThemeSettingsInternal): ({
     id: string;
     name: string;
     custom: {

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/translations/treemap/treemap-labels.d.ts

@@ -1,6 +1,6 @@
 import Highcharts, { PointLabelObject } from '@sisense/sisense-charts';
-import { CompleteThemeSettings, TreemapSeriesLabels } from '../../../../../../types';
+import { CompleteThemeSettingsInternal, TreemapSeriesLabels } from '../../../../../../types';
 import { CategoricalChartDataOptionsInternal } from '../../../chart-data-options/types';
 import { TreemapChartDesignOptions } from '../design-options';
-export declare function prepareTreemapLevels(dataOptions: CategoricalChartDataOptionsInternal, chartDesignOptions: TreemapChartDesignOptions, themeSettings?: CompleteThemeSettings): Highcharts.PlotTreegraphLevelsOptions[];
+export declare function prepareTreemapLevels(dataOptions: CategoricalChartDataOptionsInternal, chartDesignOptions: TreemapChartDesignOptions, themeSettings?: CompleteThemeSettingsInternal): Highcharts.PlotTreegraphLevelsOptions[];
 export declare function prepareTreemapLabelFormatter(level: number, seriesLabels: TreemapSeriesLabels): (this: PointLabelObject) => string;

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/translations/treemap/treemap-options.d.ts

@@ -1,7 +1,7 @@
 import { TFunction } from '@sisense/sdk-common';
-import { CompleteThemeSettings } from '../../../../../../types';
+import { CompleteThemeSettingsInternal } from '../../../../../../types';
 import { CategoricalChartDataOptionsInternal } from '../../../chart-data-options/types';
 import { CategoricalChartData } from '../../../chart-data/types';
 import { HighchartsOptionsInternal } from '../../chart-options-service';
 import { TreemapChartDesignOptions } from '../design-options';
-export declare function prepareTreemapOptions(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: TreemapChartDesignOptions, translate: TFunction, themeSettings?: CompleteThemeSettings): HighchartsOptionsInternal;
+export declare function prepareTreemapOptions(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: TreemapChartDesignOptions, translate: TFunction, themeSettings?: CompleteThemeSettingsInternal): HighchartsOptionsInternal;

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/translations/treemap/treemap-series.d.ts

@@ -1,5 +1,5 @@
-import { CompleteThemeSettings } from '../../../../../../types';
+import { CompleteThemeSettingsInternal } from '../../../../../../types';
 import { CategoricalChartDataOptionsInternal } from '../../../chart-data-options/types';
 import { CategoricalChartData } from '../../../chart-data/types';
 import { SeriesPointStructure } from '../translations-to-highcharts';
-export declare function prepareTreemapDataItems(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, themeSettings?: CompleteThemeSettings): SeriesPointStructure[];
+export declare function prepareTreemapDataItems(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, themeSettings?: CompleteThemeSettingsInternal): SeriesPointStructure[];

package/dist/packages/sdk-ui/src/domains/visualizations/core/query-definition/filter-to-readable-label.d.ts

@@ -0,0 +1,14 @@
+import type { Filter } from '@sisense/sdk-data';
+/**
+ * Builds a human-readable one-line label for a {@link Filter}, covering common
+ * `filterType` variants (`members`, `exclude`, `text`, `numeric`, `dateRange`, etc.).
+ *
+ * Discrimination uses the `filterType` string rather than `instanceof` so the helper
+ * stays robust when multiple `@sisense/sdk-data` copies exist in a workspace.
+ *
+ * @param filter - Filter instance to describe
+ * @param attributeName - Optional display name override (e.g. i18n date-level label)
+ * @returns Readable pill label; falls back to the attribute name when composition fails
+ * @sisenseInternal
+ */
+export declare function toReadableFilterLabel(filter: Filter, attributeName?: string): string;

package/dist/packages/sdk-ui/src/domains/visualizations/core/query-definition/index.d.ts

@@ -3,6 +3,7 @@ export type { QueryDefinitionProps } from './query-definition';
 export { QueryPill } from './query-pill';
 export type { QueryPillProps } from './query-pill';
 export { baseQueryParamsToViewModel } from './query-params-to-view-model';
+export { toReadableFilterLabel } from './filter-to-readable-label';
 export { getQueryPillTooltipModel } from './compose-code-to-readable';
 export type { TooltipModel } from './compose-code-to-readable';
 export type { QueryPillCategory, QueryPillItem, ConnectorItem, QueryDefinitionViewModel, } from './types';

package/dist/packages/sdk-ui/src/domains/visualizations/core/query-definition/query-definition.d.ts

@@ -16,6 +16,11 @@ export interface QueryDefinitionProps {
      * root is only one row tall and must not be used as boundary (breaks vertical placement).
      */
     tooltipBoundaryElement?: HTMLElement | null;
+    /**
+     * Maximum number of characters shown in each pill label before truncation (default `25`).
+     * Pass `0` to show the full label.
+     */
+    maxPillLength?: number;
 }
 /**
  * Read-only query definition as colored pills above the widget.

package/dist/packages/sdk-ui/src/domains/visualizations/core/query-definition/query-pill.d.ts

@@ -9,6 +9,11 @@ export interface QueryPillProps {
     item: QueryPillItem;
     showTooltip?: boolean;
     tooltipBoundaryElement?: HTMLElement | null;
+    /**
+     * Maximum number of characters shown in the pill label before truncation.
+     * When `0` or omitted, the full label is shown.
+     */
+    maxLength?: number;
 }
 /**
  * Read-only query-definition pill; JSON tooltip is a portal bubble with a real triangle.

package/dist/packages/sdk-ui/src/domains/visualizations/core/query-definition/truncate-pill-label.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Truncates a pill label when it exceeds `maxLength`. When `maxLength` is zero or negative,
+ * the label is returned unchanged.
+ *
+ * @param label - Full pill label
+ * @param maxLength - Maximum number of characters before truncation; `0` disables truncation
+ * @returns Truncated label with an ellipsis suffix when shortened
+ * @internal
+ */
+export declare function truncatePillLabel(label: string, maxLength: number): string;

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

@@ -69,5 +69,11 @@ export type PivotTableWidgetChangeEvent = PivotTableWidgetDrilldownSelectionsCha
  *   }
  * }}
  * ```
+ *
+ * Persistable state changes (e.g. scroll position, future title/customOptions)
+ * flow through {@link WidgetPropsUpdate} and `DashboardPersistenceManager.updateWidget`,
+ * NOT through this channel. Use `WidgetChangeEvent` for transient/interactive
+ * events; use `WidgetPropsUpdate` for "if this is lost on reload, the user
+ * notices."
  */
 export type WidgetChangeEvent = ChartWidgetChangeEvent | PivotTableWidgetChangeEvent;

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

@@ -97,6 +97,15 @@ export interface ChartWidgetProps extends ChartEventProps {
      * @category Widget
      */
     highlightSelectionDisabled?: boolean;
+    /**
+     * Widget identifier
+     *
+     * The optional property which is only meaningful for some internal features (for example Excel export).
+     *
+     * @category Widget
+     * @internal
+     */
+    id?: string;
     /**
      * Callback to receive widget change events.
      *

package/dist/packages/sdk-ui/src/domains/widgets/components/chart-widget/use-chart-widget-excel-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 UseChartWidgetExcelDownloadParams = Pick<ChartWidgetProps, 'title' | 'dataOptions' | 'chartType' | 'config' | 'dataSource' | 'id'> & {
+    baseHeaderConfig: WidgetHeaderConfig;
+};
+export type UseChartWidgetExcelDownloadResult = {
+    headerConfig: WidgetHeaderConfig;
+};
+/**
+ * Enhances a chart widget header with Excel download menu items (placeholder).
+ * Excel menu is shown only when the widget/dashboard allows download **and**
+ * the Sisense server feature **`exportingXlsxV2`** is active (`api/globals` → `features`).
+ * **Repeat rows** sets `mergeRows: false`; **Merge rows** sets `mergeRows: true`).
+ *
+ * @param props - Chart data/config plus `baseHeaderConfig`. `id` is optional; when present it is forwarded as `widgetId` without validation.
+ * @returns Header config for {@link WidgetContainer}
+ */
+export declare function useChartWidgetExcelDownload(props: UseChartWidgetExcelDownloadParams): UseChartWidgetExcelDownloadResult;

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

@@ -1,4 +1,5 @@
 import { DataSource, Filter, FilterRelations } from '@sisense/sdk-data';
+import type { VisualizationStateUpdate } from '../../../../infra/plugins/widget-plugins/types';
 import { CustomWidgetEventProps, CustomWidgetStyleOptions, GenericDataOptions } from '../../../../types';
 import { WidgetConfig } from '../widget/types';
 /**
@@ -56,6 +57,15 @@ export interface CustomWidgetProps extends CustomWidgetEventProps {
      * @category Widget
      */
     title?: string;
+    /**
+     * Widget identifier
+     *
+     * The optional property which is only meaningful for some internal features (for example Excel export).
+     *
+     * @category Widget
+     * @internal
+     */
+    id?: string;
     /**
      *  Description of the widget
      *
@@ -68,4 +78,14 @@ export interface CustomWidgetProps extends CustomWidgetEventProps {
      * @category Widget
      */
     customOptions?: Record<string, any>;
+    /**
+     * Emit a partial state update to be persisted through the dashboard
+     * persistence layer. Injected by the dashboard composition layer
+     * (`useWidgetUpdatesPersistence`) and forwarded to the plugin visualization
+     * component as {@link CustomVisualizationProps.onChange}.
+     *
+     * @category Widget
+     * @internal
+     */
+    onChange?: (update: VisualizationStateUpdate) => void;
 }

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

@@ -0,0 +1,16 @@
+import type { WidgetHeaderConfig } from '../../../../domains/widgets/shared/widget-header/types.js';
+import type { CustomWidgetProps } from './types.js';
+export type UseCustomWidgetExcelDownloadParams = Pick<CustomWidgetProps, 'title' | 'dataOptions' | 'filters' | 'highlights' | 'config' | 'dataSource' | 'customWidgetType' | 'id'> & {
+    baseHeaderConfig: WidgetHeaderConfig;
+};
+export type UseCustomWidgetExcelDownloadResult = {
+    headerConfig: WidgetHeaderConfig;
+};
+/**
+ * Enhances a custom widget header with Excel download menu items when the server feature
+ * **`exportingXlsxV2`** is active. **Repeat rows** sets `mergeRows: false`; **Merge rows** sets `mergeRows: true`.
+ *
+ * @param props - Custom widget data plus `baseHeaderConfig` (typically from {@link useCustomWidgetCsvDownload}).
+ * @returns Header config for {@link WidgetContainer}
+ */
+export declare function useCustomWidgetExcelDownload(props: UseCustomWidgetExcelDownloadParams): UseCustomWidgetExcelDownloadResult;

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

@@ -1,5 +1,20 @@
 import { type FunctionComponent } from 'react';
 import { PivotTableWidgetProps } from './types';
+/**
+ * Computes the outer widget height in auto-height mode.
+ *
+ * The inner pivot reports only its own table height. The widget reserves additional vertical
+ * space above the pivot — the container chrome (header + `spaceAround` padding, SNS-127785) and
+ * the optional top slot (e.g. drilldown breadcrumbs, SNS-128141). Callers must sum all such
+ * non-pivot reserved space into `reservedHeight` so that pagination at the bottom of the pivot
+ * remains reachable.
+ *
+ * @param pivotTableHeight - The measured content height of the pivot table.
+ * @param reservedHeight - The total non-pivot vertical space the widget reserves (chrome + topSlot).
+ * @returns The total widget height in pixels, or `undefined` when the content height is unknown.
+ * @internal
+ */
+export declare function calcPivotTableWidgetHeight(pivotTableHeight: number | undefined, reservedHeight: number): number | undefined;
 /**
  * React component extending `PivotTable` to support widget style options.
  *
@@ -33,7 +48,6 @@ import { PivotTableWidgetProps } from './types';
  * />
  * ```
  * <img src="media://pivot-widget-example.png" width="800px" />
- *
  * @param props - Pivot Table Widget properties
  * @returns Widget component representing a pivot table
  * @group Dashboards

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

@@ -70,6 +70,15 @@ export interface PivotTableWidgetProps {
      * @category Widget
      */
     title?: string;
+    /**
+     * Widget identifier
+     *
+     * The optional property which is only meaningful for some internal features (for example Excel export).
+     *
+     * @category Widget
+     * @internal
+     */
+    id?: string;
     /**
      *  Description of the widget
      *
@@ -112,7 +121,6 @@ export interface PivotTableWidgetProps {
      *   }
      * };
      * ```
-     *
      * @internal
      */
     onDataCellFormat?: CustomDataCellFormatter;
@@ -134,7 +142,6 @@ export interface PivotTableWidgetProps {
      *   }
      * };
      * ```
-     *
      * @internal
      */
     onHeaderCellFormat?: CustomHeaderCellFormatter;

package/dist/packages/sdk-ui/src/domains/widgets/components/pivot-table-widget/use-pivot-widget-excel-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 UsePivotWidgetExcelDownloadParams = Pick<PivotTableWidgetProps, 'title' | 'dataOptions' | 'config' | 'dataSource' | 'filters' | 'highlights' | 'id'> & {
+    baseHeaderConfig: WidgetHeaderConfig;
+};
+export type UsePivotWidgetExcelDownloadResult = {
+    headerConfig: WidgetHeaderConfig;
+};
+/**
+ * Enhances a pivot table widget header with Excel download menu items.
+ * Excel menu is shown only when the widget/dashboard allows download **and**
+ * the Sisense server feature **`exportingXlsxV2`** is active (`api/globals` → `features`).
+ * **Repeat rows** sets `mergeRows: false`; **Merge rows** sets `mergeRows: true`).
+ *
+ * @param props - Pivot data/config plus `baseHeaderConfig`. `id` is optional; when present it is forwarded as `widgetId` without validation.
+ * @returns Header config for {@link WidgetContainer}
+ */
+export declare function usePivotWidgetExcelDownload(props: UsePivotWidgetExcelDownloadParams): UsePivotWidgetExcelDownloadResult;

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

@@ -32,6 +32,19 @@ export type WidgetConfig = {
              */
             enabled?: boolean;
         };
+        /**
+         * Configuration for downloading an Excel file.
+         *
+         * @sisenseInternal
+         */
+        downloadExcel?: {
+            /**
+             * Determines whether the possibility to download Excel is enabled.
+             *
+             * If not specified, the default value is `false`.
+             */
+            enabled?: boolean;
+        };
     };
 };
 /**

package/dist/packages/sdk-ui/src/domains/widgets/components/widget-by-id/translate-widget-style-options/to-widget-dto-style.d.ts

@@ -1,7 +1,8 @@
 import type { PivotGrandTotals } from '@sisense/sdk-data';
+import type { BoxWhiskerType } from '../../../../../domains/visualizations/core/chart-data-options/types.js';
 import { AppSettings } from '../../../../../infra/app/settings/settings.js';
-import type { AreamapType, AreaStyleOptions, AxisLabel, CompleteThemeSettings, DataLimits, FunnelStyleOptions, IndicatorStyleOptions, LegendOptions, LineStyleOptions, LineWidth, Markers, Navigator, PieStyleOptions, PivotTableWidgetStyleOptions, PolarStyleOptions, ScattermapStyleOptions, ScatterStyleOptions, SeriesLabels, StackableStyleOptions, SunburstStyleOptions, TableStyleOptions, TreemapStyleOptions, WidgetStyleOptions } from '../../../../../types.js';
-import type { AxisStyle, CartesianWidgetStyle, FunnelWidgetStyle, PivotWidgetStyle, PolarWidgetStyle, ScattermapWidgetStyle, ScatterWidgetStyle, SunburstWidgetStyle, TableWidgetStyle, TreemapWidgetStyle, WidgetDesign, WidgetStyle, WidgetSubtype } from '../types.js';
+import type { AreamapType, AreaStyleOptions, AxisLabel, BoxplotStyleOptions, CalendarHeatmapStyleOptions, CompleteThemeSettingsInternal, DataLimits, FunnelStyleOptions, IndicatorStyleOptions, LegendOptions, LineStyleOptions, LineWidth, Markers, Navigator, PieStyleOptions, PivotTableWidgetStyleOptions, PolarStyleOptions, ScattermapStyleOptions, ScatterStyleOptions, SeriesLabels, StackableStyleOptions, SunburstStyleOptions, TableStyleOptions, TreemapStyleOptions, WidgetStyleOptions } from '../../../../../types.js';
+import type { AxisStyle, BoxplotWidgetStyle, CalendarHeatmapWidgetStyle, CartesianWidgetStyle, FunnelWidgetStyle, PivotWidgetStyle, PolarWidgetStyle, ScattermapWidgetStyle, ScatterWidgetStyle, SunburstWidgetStyle, TableWidgetStyle, TreemapWidgetStyle, WidgetDesign, WidgetStyle, WidgetSubtype } from '../types.js';
 /**
  * Maps SDK legend options to Fusion DTO legend style.
  *
@@ -69,7 +70,7 @@ export declare function hasWidgetContainerStyleFields(styleOptions: WidgetStyleO
  *
  * @internal
  */
-export declare function toWidgetDesign(styleOptions: WidgetStyleOptions, widgetTheme: CompleteThemeSettings['widget']): WidgetDesign | undefined;
+export declare function toWidgetDesign(styleOptions: WidgetStyleOptions, widgetTheme: CompleteThemeSettingsInternal['widget']): WidgetDesign | undefined;
 /**
  * Attaches `style.widgetDesign` built from widget container fields in `styleOptions`.
  * When the feature flag is off, or when `styleOptions` carries no container fields, the
@@ -81,7 +82,7 @@ export declare function toWidgetDesign(styleOptions: WidgetStyleOptions, widgetT
  * @param appSettings - The application settings to be used for the widget design
  * @returns The widget style with the widget design
  */
-export declare function withWidgetDesign(baseStyle: WidgetStyle, styleOptions: WidgetStyleOptions, themeSettings: CompleteThemeSettings, appSettings?: AppSettings): WidgetStyle;
+export declare function withWidgetDesign(baseStyle: WidgetStyle, styleOptions: WidgetStyleOptions, themeSettings: CompleteThemeSettingsInternal, appSettings?: AppSettings): WidgetStyle;
 /**
  * Maps SDK pie chart style options to Fusion PieWidgetStyle (DTO).
  * Inverse of {@link extractPieChartStyleOptions}.
@@ -211,6 +212,44 @@ export declare function toScattermapWidgetStyle(styleOptions: ScattermapStyleOpt
  * @internal
  */
 export declare function toAreamapSubtype(mapType?: AreamapType): 'areamap/world' | 'areamap/usa';
+/**
+ * Converts boxplot style options to Fusion BoxplotWidgetStyle DTO.
+ * Inverse of `extractBoxplotChartStyleOptions`.
+ *
+ * The whisker algorithm (`boxType`) and `outliersEnabled` flag live on
+ * {@link BoxplotChartDataOptions} in the WidgetModel rather than on `styleOptions`,
+ * so they are passed in separately. `boxType` defaults to `'iqr'` — the same default
+ * the boxplot translator falls back to when no whisker flag is selected.
+ *
+ * @param styleOptions - Boxplot style options from WidgetModel.styleOptions
+ * @param boxType - Whisker algorithm from WidgetModel.dataOptions.boxType
+ * @param outliersEnabled - Whether to render boxplot outliers
+ * @returns Fusion BoxplotWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toBoxplotWidgetStyle(styleOptions: BoxplotStyleOptions, boxType?: BoxWhiskerType, outliersEnabled?: boolean): BoxplotWidgetStyle;
+/**
+ * Converts calendar-heatmap style options to Fusion CalendarHeatmapWidgetStyle DTO.
+ * Inverse of {@link extractCalendarHeatmapChartStyleOptions}.
+ *
+ * Only the fields the inverse extractor reads are round-trippable. Cosmetic fields
+ * that the extractor synthesizes from {@link CALENDAR_HEATMAP_DEFAULTS}
+ * (`monthLabels.enabled`, `weekends.cellColor`, `weekends.hideValues`,
+ * `pagination.enabled`) are not written back because the Fusion DTO has no fields
+ * for them.
+ *
+ * The CSDK `subtype` (`'calendar-heatmap/split' | 'calendar-heatmap/continuous'`)
+ * is NOT the DTO `subtype` — the DTO uses `'heatmap'` and encodes view as the
+ * `'view/weekly'` / `'view/monthly'` style flags.
+ *
+ * `pagination.startMonth` is emitted as `{year, month}` because Fusion's startMonth
+ * object form is the canonical write shape; the string form is read-only legacy input.
+ *
+ * @param styleOptions - Calendar heatmap style options from WidgetModel.styleOptions
+ * @returns Fusion CalendarHeatmapWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toCalendarHeatmapWidgetStyle(styleOptions: CalendarHeatmapStyleOptions): CalendarHeatmapWidgetStyle;
 /**
  * Converts table style options to Fusion TableWidgetStyle DTO.
  * Used when serializing a table widget back to WidgetDto.

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

@@ -77,6 +77,12 @@ export interface WidgetDto {
         supportsHierarchies?: boolean;
         imageColumns?: number[];
     };
+    /**
+     * Custom-widget-specific runtime options bag, persisted across reloads for
+     * custom (plugin) widgets. Round-trips opaquely between the Fusion DTO and the
+     * CSDK widget model's `customOptions`.
+     */
+    customOptions?: Record<string, unknown>;
     source?: any;
     owner?: string;
     userId?: string;

package/dist/packages/sdk-ui/src/domains/widgets/helpers/download-blob-as-file.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Triggers a browser file download from a Blob.
+ *
+ * @param blob - Blob to download
+ * @param filename - Suggested file name
+ */
+export declare function downloadBlobAsFile(blob: Blob, filename: string): void;
+/**
+ * Normalizes a file name by removing invalid characters and keeping the extension.
+ *
+ * @param rawFileName - Raw file name
+ * @returns Normalized file name
+ */
+export declare function normalizeFileName(rawFileName: string): string;

package/dist/packages/sdk-ui/src/domains/widgets/helpers/excel-export-map-dimensions-measures.d.ts

@@ -0,0 +1,18 @@
+import { type Attribute, type Measure } from '@sisense/sdk-data';
+/**
+ * Returns attributes prepared for Excel JAQL export: dimensional level attributes without an
+ * explicit display format receive a level-appropriate default so the backend renders human-readable
+ * date strings (e.g. "2009" for Years) instead of raw datetime values.
+ * Attributes that already carry a display format are returned unchanged.
+ *
+ * @param attributes - Raw attributes from chart or pivot translation
+ * @returns New array of attributes safe to pass as export dimensions
+ */
+export declare function mapAttributesForExcelExport(attributes: readonly Attribute[]): Attribute[];
+/**
+ * Returns measures prepared for Excel JAQL export: applies a default number format when none is set.
+ *
+ * @param measures - Raw measures from chart or pivot translation
+ * @returns New array of measures safe to pass as export measures
+ */
+export declare function mapMeasuresForExcelExport(measures: readonly Measure[]): Measure[];

package/dist/packages/sdk-ui/src/domains/widgets/helpers/index.d.ts

@@ -3,6 +3,8 @@
  * @internal
  */
 export declare const widgetHelpers: {
+    downloadBlobAsFile(blob: Blob, filename: string): void;
+    normalizeFileName(rawFileName: string): string;
     withMenuItemInHeaderConfig(menuItem: import("../../../shared/types/menu-item").MenuItem): (headerConfig: import("../shared/widget-header/types").WidgetHeaderConfig) => import("../shared/widget-header/types").WidgetHeaderConfig;
     withHeaderMenuItem(menuItem: import("../../../shared/types/menu-item").MenuItem): (widget: import("../components/widget").WidgetProps) => import("../components/widget").WidgetProps;
 };

package/dist/packages/sdk-ui/src/domains/widgets/hooks/use-excel-query-file-loader.d.ts

@@ -0,0 +1,13 @@
+import type { ExecuteExcelQueryParams } from '../../../domains/query-execution/types.js';
+export type ExcelExecuteParams = Omit<ExecuteExcelQueryParams, 'enabled' | 'exportRunId'>;
+export type UseExcelQueryLoaderResult = {
+    /** Triggers Excel export and browser file download with the given params. */
+    execute: (params: ExcelExecuteParams) => void;
+};
+/**
+ * Hook that runs an Excel JAQL export on demand and triggers a browser file download.
+ * Uses {@link useExecuteExcelQueryInternal} for loading and error state (mirrors {@link useCsvQueryFileLoader}).
+ *
+ * @returns `execute` callback
+ */
+export declare function useExcelQueryFileLoader(): UseExcelQueryLoaderResult;

package/dist/packages/sdk-ui/src/domains/widgets/hooks/use-track-widget-init.d.ts

@@ -0,0 +1,44 @@
+import type { WidgetType } from '../components/widget/types';
+/**
+ * Fully resolved options for {@link useTrackWidgetInit}. The caller (a leaf widget) is
+ * responsible for deriving each field from its own props so the hook stays free of
+ * widget-shape concerns and runtime type casts.
+ *
+ * @internal
+ */
+export type UseTrackWidgetInitOptions = {
+    /** Widget type (chart / pivot / text / custom). */
+    widgetType: WidgetType;
+    /** Resolved widget kind — chart subtype, plugin name, or fixed string for pivot/text. */
+    widgetName: string;
+    /** Widget title entered by the designer, or `null` if absent. */
+    widgetTitle: string | null;
+    /** Stable unique widget identifier — the widget id/OID when available, otherwise a content hash. */
+    entityId: string;
+    /**
+     * When `false`, the event is suppressed. Pass the caller's render preconditions here
+     * (e.g. `!!(chartType && dataOptions)` for `ChartWidget`) so we do not count mounts
+     * whose render body early-returns `null`. The event fires once when this flips to `true`.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+};
+/**
+ * Fires the `sdkWidgetInit` tracking event exactly once per widget mount.
+ *
+ * Behavioral note: unlike `useTrackComponentInit`, this hook intentionally
+ * IGNORES `TrackingContextProvider`'s skip-nested signal. Widgets rendered inside
+ * a tracked parent (e.g. a `<Dashboard>`) must still emit `sdkWidgetInit`, since
+ * the event must count every widget render regardless of nesting.
+ *
+ * The payload includes envelope overrides (`eventType: 'action'`,
+ * `featureName: 'composesdk'`, `entityType: 'widget'`) that override the defaults
+ * set by `trackProductEvent`, as required by the data-tracking spec.
+ *
+ * `widgetTitle` is emitted as `null` rather than `undefined` when absent, matching the
+ * spec's "null or [empty]" wire convention.
+ *
+ * @internal
+ */
+export declare const useTrackWidgetInit: (options: UseTrackWidgetInitOptions) => void;

package/dist/packages/sdk-ui/src/domains/widgets/hooks/use-with-excel-download-menu-item.d.ts

@@ -0,0 +1,21 @@
+import type { WidgetHeaderConfig } from '../../../domains/widgets/shared/widget-header/types.js';
+export type UseWithExcelDownloadMenuParams = {
+    /** Base header config. */
+    baseHeaderConfig: WidgetHeaderConfig;
+    /** Whether Excel download menu items are shown. */
+    enabled: boolean;
+    /** Triggers Excel download; receives `mergeRows` flag (Angular: `buildRequest(..., mergeRows)`). */
+    onDownloadExcel: (mergeRows: boolean) => void;
+};
+/**
+ * Appends **Download → Excel File → (Repeat rows | Merge rows)** to the widget header menu when enabled.
+ *
+ * If a **Download** group (`widget-download`) already exists (e.g. after CSV), the **Excel File** branch is appended to its `items` (any prior `excelFileMenuItem` entry is removed first so it is not duplicated).
+ * Otherwise a new **Download** group containing only the Excel subtree is appended.
+ *
+ * @param params.baseHeaderConfig - Base header config.
+ * @param params.enabled - When false, returns `baseHeaderConfig` unchanged.
+ * @param params.onDownloadExcel - Invoked with `mergeRows` false for "Repeat rows", true for "Merge rows".
+ * @returns Header config to pass to {@link WidgetContainer}
+ */
+export declare function useWithExcelDownloadMenuItem({ baseHeaderConfig, enabled, onDownloadExcel, }: UseWithExcelDownloadMenuParams): WidgetHeaderConfig;