@sisense/sdk-ui 2.26.0 → 2.28.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: {
@@ -26,8 +26,8 @@ export declare function prepareSunburstLevels(chartData: CategoricalChartData, d
         align?: "left" | "center" | "right" | undefined;
         verticalAlign?: "top" | "middle" | "bottom" | undefined;
         style?: import("../types").TextStyle | undefined;
-        backgroundColor?: string | import("../../../../../..").HighchartsGradientColorObject | undefined;
-        borderColor?: string | import("../../../../../..").HighchartsGradientColorObject | undefined;
+        backgroundColor?: string | import("../../../../../../shared/utils/gradient").HighchartsGradientColorObject | undefined;
+        borderColor?: string | import("../../../../../../shared/utils/gradient").HighchartsGradientColorObject | undefined;
         borderRadius?: number | undefined;
         borderWidth?: number | undefined;
         padding?: number | undefined;

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;
@@ -84,8 +84,8 @@ export declare function prepareSunburstSeries(chartData: CategoricalChartData, d
             align?: "left" | "center" | "right" | undefined;
             verticalAlign?: "top" | "middle" | "bottom" | undefined;
             style?: import("../types").TextStyle | undefined;
-            backgroundColor?: string | import("../../../../../..").HighchartsGradientColorObject | undefined;
-            borderColor?: string | import("../../../../../..").HighchartsGradientColorObject | undefined;
+            backgroundColor?: string | import("../../../../../../shared/utils/gradient").HighchartsGradientColorObject | undefined;
+            borderColor?: string | import("../../../../../../shared/utils/gradient").HighchartsGradientColorObject | undefined;
             borderRadius?: number | undefined;
             borderWidth?: number | undefined;
             padding?: number | undefined;
@@ -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/query-definition-style-constants.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared typography for the query-definition row, pill labels, and tooltip body.
+ *
+ * @internal
+ */
+export declare const QUERY_DEFINITION_TEXT_STYLE: {
+    readonly fontSize: "13px";
+};
+/**
+ * Pill label line height matches design spec on top of {@link QUERY_DEFINITION_TEXT_STYLE}.
+ *
+ * @internal
+ */
+export declare const QUERY_PILL_LABEL_STYLE: {
+    readonly lineHeight: "17px";
+    readonly fontSize: "13px";
+};

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

@@ -1,5 +1,5 @@
 import { type FunctionComponent } from 'react';
-import type { BaseQueryParams } from '../../../../domains/query-execution/types';
+import type { ExecuteQueryParams } from '../../../../domains/query-execution/types';
 import type { ChartProps } from '../../../../props';
 /**
  * Props for the QueryDefinition component.
@@ -7,8 +7,8 @@ import type { ChartProps } from '../../../../props';
  * @sisenseInternal
  */
 export interface QueryDefinitionProps {
-    /** Either chart props (uses getTranslatedDataOptions internally) or base query params */
-    query: BaseQueryParams | ChartProps;
+    /** Either chart props (uses getTranslatedDataOptions internally) or query params (same shape as {@link useExecuteQuery}) */
+    query: ExecuteQueryParams | ChartProps;
     /** When true (default), pills show JSON tooltip on hover. */
     showTooltip?: boolean;
     /**

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

@@ -4,9 +4,9 @@ import type { QueryDefinitionViewModel } from './types';
 /**
  * Builds the query definition view model from base query params.
  * Order: Measures → "by" → Dimensions → "for"/"where" → Filters.
- * Operators (comparison/sort) are not derived from BaseQueryParams in v1.
+ * Operators (comparison/sort) are not derived from base query fields in v1.
  *
- * @param params - BaseQueryParams from chart or query
+ * @param params - Base query fields from chart or query; accepts {@link ExecuteQueryParams} (execution-only fields are ignored).
  * @param t - Optional i18n translate function. When provided, date-level (`DimensionalLevelAttribute`)
  *   dimensions and filters use `attribute.datetimeName.*` strings (e.g. "Months in Date"). When omitted,
  *   labels match the previous behavior (`attr.name` only).

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

@@ -56,6 +56,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
      *

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

@@ -33,7 +33,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/pivot-table-widget/use-with-pivot-table-widget-drilldown.d.ts

@@ -7,7 +7,6 @@ type UseWithPivotTableWidgetDrilldownParams = {
 };
 type UseWithPivotTableWidgetDrilldownResult = {
     propsWithDrilldown: PivotTableWidgetProps;
-    isDrilldownEnabled: boolean;
     breadcrumbs: JSX.Element;
 };
 export declare function useWithPivotTableWidgetDrilldown(params: UseWithPivotTableWidgetDrilldownParams): UseWithPivotTableWidgetDrilldownResult;

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

@@ -10,11 +10,6 @@ import { DataOptionLocation, DrilldownSelection } from '../../../../types';
  * @returns The initial dimension location.
  */
 export declare function getInitialDimensionLocation(dataOptions: PivotTableDataOptions, drilldownTarget: Attribute | DataOptionLocation, drilldownSelections: DrilldownSelection[]): DataOptionLocation | undefined;
-/**
- * Checks if drilldown is applicable to a pivot table.
- * Drilldown requires the pivot table to have at least one selectable attribute (row or column dimension).
- */
-export declare function isDrilldownApplicableToPivot(dataOptions: PivotTableDataOptions): boolean;
 /**
  * Applies a drilldown dimension to pivot table data options.
  * Replaces the target dimension (first row or column that doesn't match the drilldown dimension).

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/apply-partial-dto-style.d.ts

@@ -0,0 +1,18 @@
+import type { WidgetStyle } from '../types.js';
+import type { UnsupportedStyleOptions } from './extract-unsupported-style-options.js';
+/**
+ * Layers `partialStyle` (the unsupported style fields snapshot from the original
+ * Fusion DTO, see {@link extractUnsupportedStyleOptions}) underneath the freshly
+ * `rebuiltStyle` produced by `to*WidgetStyle`.
+ *
+ * Priority (highest to lowest):
+ *   1. `rebuiltStyle` — values produced by the SDK → DTO translation.
+ *   2. `partialStyle` — values plucked from the original DTO.
+ *
+ * Implemented with `lodash-es/merge`, which performs a deep merge and skips
+ * `undefined` source values, so any field the rebuild does emit takes precedence
+ * while gap fields the rebuild leaves untouched are filled in from `partialStyle`.
+ *
+ * @internal
+ */
+export declare function applyPartialDtoStyle<T extends WidgetStyle>(rebuiltStyle: T, partialStyle?: UnsupportedStyleOptions): T;

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

@@ -0,0 +1,31 @@
+import type { WidgetDto, WidgetStyle } from '../types.js';
+/**
+ * Loose record of unsupported style fields preserved from the original
+ * Fusion DTO. Returned by {@link extractUnsupportedStyleOptions}.
+ *
+ * Typed as `Record<string, unknown>` because the keys and shapes go beyond
+ * what `WidgetStyle` declares — e.g. `'center/value'` on sunburst, or
+ * `'borders/grid'` on table widgets. Stored on
+ * `SpecificWidgetOptions.partialDtoOptions.style` and re-attached when
+ * serializing back to a DTO via `applyPartialDtoStyle` so values survive
+ * Fusion → CSDK → Fusion round-trips.
+ *
+ * @internal
+ */
+export type UnsupportedStyleOptions = Record<string, unknown>;
+/**
+ * Extracts the style fields that the CSDK widget model does not currently
+ * translate to first-class `WidgetStyleOptions` for the given widget type.
+ *
+ * The result is stored on `SpecificWidgetOptions.partialDtoOptions.style` and
+ * re-attached during CSDK → Fusion serialization (see `applyPartialDtoStyle`).
+ * Returns an empty object for widget types that have no known unsupported
+ * style fields, or for unknown / plugin types whose raw style is opaque to
+ * the CSDK.
+ *
+ * @param widgetType - Fusion widget type from `WidgetDto.type`
+ * @param style - Raw `WidgetDto.style` from the server
+ * @returns A partial style containing only known-unsupported fields
+ * @internal
+ */
+export declare function extractUnsupportedStyleOptions(widgetType: WidgetDto['type'], style: WidgetStyle | undefined): UnsupportedStyleOptions;

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

@@ -1,2 +1,4 @@
+export * from './apply-partial-dto-style.js';
+export * from './extract-unsupported-style-options.js';
 export * from './translate-widget-style-options.js';
 export * from './to-widget-dto-style.js';

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

@@ -1,6 +1,6 @@
 import type { PivotGrandTotals } from '@sisense/sdk-data';
 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 { AreamapType, AreaStyleOptions, AxisLabel, 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, 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 +69,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 +81,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}.

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

@@ -32,7 +32,7 @@ export type CsdkPluginWidgetType = 'tabber-buttons';
 /**
  * The type of a widget on a dashboard.
  */
-export type FusionWidgetType = CartesianWidgetType | CategoricalWidgetType | 'chart/scatter' | 'indicator' | TabularWidgetType | 'chart/boxplot' | 'map/scatter' | 'map/area' | 'heatmap' | TextWidgetType | FusionPluginWidgetType | 'custom';
+export type FusionWidgetType = CartesianWidgetType | CategoricalWidgetType | 'chart/scatter' | 'indicator' | TabularWidgetType | 'chart/boxplot' | 'map/scatter' | 'map/area' | 'heatmap' | TextWidgetType | FusionPluginWidgetType | string;
 export type WidgetSubtype = 'area/basic' | 'area/stacked' | 'area/stacked100' | 'area/spline' | 'area/stackedspline' | 'area/stackedspline100' | 'bar/classic' | 'bar/stacked' | 'bar/stacked100' | 'column/classic' | 'column/stackedcolumn' | 'column/stackedcolumn100' | 'line/basic' | 'line/spline' | 'pie/classic' | 'pie/donut' | 'pie/ring' | 'column/polar' | 'area/polar' | 'line/polar' | 'indicator/numeric' | 'indicator/gauge' | 'bubble/scatter' | 'treemap' | 'sunburst' | 'boxplot/full' | 'boxplot/hollow' | 'map/scatter' | 'areamap/world' | 'areamap/usa' | 'richtexteditor';
 export declare enum WidgetDashboardFilterMode {
     FILTER = "filter",

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

@@ -27,7 +27,7 @@ export declare function isMeasurePanelItem(item: PanelItem): boolean;
  */
 export declare function getChartType(fusionWidgetType: FusionWidgetType): ChartType | undefined;
 export declare function getFusionWidgetTypeFromChartType(chartType: ChartType): FusionWidgetType;
-export declare function getFusionWidgetType(widgetType: WidgetType, chartType?: ChartType): FusionWidgetType;
+export declare function getFusionWidgetType(widgetType: WidgetType, chartType?: ChartType, customWidgetType?: string): FusionWidgetType;
 export declare function getWidgetType(fusionWidgetType: FusionWidgetType): WidgetType;
 export declare function getChartSubtype(widgetSubtype: WidgetSubtype): ChartSubtype | undefined;
 export declare function isSupportedWidgetType(fusionWidgetType: string): fusionWidgetType is FusionWidgetType;

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-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;

package/dist/packages/sdk-ui/src/domains/widgets/shared/widget-style-utils.d.ts

@@ -1,4 +1,4 @@
-import { CompleteThemeSettings, WidgetContainerStyleOptions } from '../../../types';
+import { CompleteThemeSettingsInternal, WidgetContainerStyleOptions } from '../../../types';
 export declare enum WidgetCornerRadius {
     'None' = "",
     'Large' = "30px",
@@ -11,4 +11,4 @@ export declare enum WidgetSpaceAround {
     'Medium' = "10px",
     'Small' = "5px"
 }
-export declare const getShadowValue: (styleOptions: WidgetContainerStyleOptions | undefined, themeSettings: CompleteThemeSettings) => string;
+export declare const getShadowValue: (styleOptions: WidgetContainerStyleOptions | undefined, themeSettings: CompleteThemeSettingsInternal) => string;

package/dist/packages/sdk-ui/src/domains/widgets/widget-model/get-widget-model.d.ts

@@ -1,6 +1,6 @@
 import { HttpClient } from '@sisense/sdk-rest-client';
 import { AppSettings } from '../../../infra/app/settings/settings';
-import { CompleteThemeSettings } from '../../../types';
+import { CompleteThemeSettingsInternal } from '../../../types';
 import { WidgetModel } from './widget-model';
 /**
  * Retrieves a widget model by its OID.
@@ -13,4 +13,4 @@ import { WidgetModel } from './widget-model';
  * @returns The widget model
  * @internal
  */
-export declare function getWidgetModel(httpClient: HttpClient, dashboardOid: string, widgetOid: string, themeSettings?: CompleteThemeSettings, appSettings?: AppSettings): Promise<WidgetModel>;
+export declare function getWidgetModel(httpClient: HttpClient, dashboardOid: string, widgetOid: string, themeSettings?: CompleteThemeSettingsInternal, appSettings?: AppSettings): Promise<WidgetModel>;

package/dist/packages/sdk-ui/src/domains/widgets/widget-model/widget-model-translator/to-widget-dto-panels.d.ts

@@ -1,5 +1,6 @@
 import { AreamapChartDataOptions, CartesianChartDataOptions, CategoricalChartDataOptions, IndicatorChartDataOptions, PivotTableDataOptions, ScatterChartDataOptions, ScattermapChartDataOptions, TableDataOptionsInternal } from '../../../../domains/visualizations/core/chart-data-options/types.js';
 import { Panel } from '../../../../domains/widgets/components/widget-by-id/types.js';
+import type { GenericDataOptions } from '../../../../types.js';
 import { ScattermapStyleOptions } from '../../../../types.js';
 /**
  * Builds DTO panels for a line chart widget. The category panel is named `x-axis`,
@@ -168,3 +169,15 @@ export declare function toScattermapPanels(dataOptions: ScattermapChartDataOptio
  * @internal
  */
 export declare function toAreamapPanels(dataOptions: AreamapChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a plugin / custom widget. Each key in {@link GenericDataOptions}
+ * becomes one panel; every Column is normalised then converted to a JAQL panel item via
+ * the same helper chart widgets use, so the DTO round-trips through `fromWidgetDto`
+ * without further translation. The `filters` key is reserved by the DTO schema and
+ * emitted separately from `widgetModel.filters`, so it is skipped here.
+ *
+ * @param dataOptions - Generic data options keyed by the plugin's input names
+ * @returns One Fusion panel per declared input
+ * @internal
+ */
+export declare function toCustomWidgetPanels(dataOptions: GenericDataOptions | undefined): Panel[];