@sisense/sdk-ui 2.29.0 → 2.31.0

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-data/scatter-data.d.ts

@@ -12,7 +12,7 @@ export interface DataOptionsIndexes {
 }
 export declare const buildCategories: (data: ScatterDataTable, axisColumnName: AxisColumnName) => string[];
 export declare const createCategoriesMap: (xCategories?: ScatterCategories, yCategories?: ScatterCategories) => ScatterAxisCategoriesMap;
-export declare const groupData: (dataOptions: ScatterChartDataOptionsInternal, dataTable: DataTable) => ScatterDataTable;
+export declare const groupData: (dataOptions: ScatterChartDataOptionsInternal, dataTable: DataTable, defaultNumberFormattingEnabled?: boolean) => ScatterDataTable;
 /**
  * Creates data for scatter charts given chart data table and data options
  *
@@ -20,4 +20,4 @@ export declare const groupData: (dataOptions: ScatterChartDataOptionsInternal, d
  * @param dataTable - Chart data table
  * @returns Scatter chart data
  */
-export declare const scatterData: (dataOptions: ScatterChartDataOptionsInternal, dataTable: DataTable) => ScatterChartData;
+export declare const scatterData: (dataOptions: ScatterChartDataOptionsInternal, dataTable: DataTable, defaultNumberFormattingEnabled?: boolean) => ScatterChartData;

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-data/types.d.ts

@@ -1,6 +1,7 @@
 import { Coordinates } from '../../../../domains/visualizations/components/chart/components/scattermap/types';
 import { AreamapData } from '../../../../domains/visualizations/components/chart/restructured-charts/areamap-chart/types';
 import { CalendarHeatmapChartData } from '../../../../domains/visualizations/components/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/data';
+import { SankeyChartData } from '../../../../domains/visualizations/components/chart/restructured-charts/highchart-based-charts/sankey-chart/types';
 import { ComparableData, Value } from '../../../../domains/visualizations/core/chart-data-processor/table-processor';
 import { IndicatorChartType } from '../../../../domains/visualizations/core/chart-options-processor/translations/types';
 import { NumberFormatConfig } from '../../../../types';
@@ -141,5 +142,5 @@ export type BoxplotChartData = {
  *
  * @internal
  */
-export type ChartData = CartesianChartData | CategoricalChartData | ScatterChartData | IndicatorChartData | BoxplotChartData | AreamapData | ScattermapChartData | RangeChartData | CalendarHeatmapChartData;
+export type ChartData = CartesianChartData | CategoricalChartData | ScatterChartData | IndicatorChartData | BoxplotChartData | AreamapData | ScattermapChartData | RangeChartData | CalendarHeatmapChartData | SankeyChartData;
 export {};

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-data-options/apply-styled-options-to-query.d.ts

@@ -72,12 +72,12 @@ export declare function isForecastMeasure(measure: Measure): boolean;
  */
 export type AdaptMeasuresForQueryOptions = {
     /**
-     * When `true`, trend and forecast companion measures are not appended (e.g. narrative when the
-     * backend does not yet support them).
+     * When `true` (default), trend and forecast will be included if present.
+     * When `false`, trend and forecast will be omitted if they are present.
      *
-     * @default false
+     * @default true
      */
-    ignoreTrendAndForecast?: boolean;
+    includeTrendAndForecast?: boolean;
 };
 /**
  * Applies sort, trend, and forecast companion measures (NLQ JSON → query semantics).

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-data-options/types.d.ts

@@ -10,12 +10,11 @@ export interface CategoryStyle {
     /** {@inheritDoc NumberFormatConfig} */
     numberFormatConfig?: NumberFormatConfig;
     /**
-     * Date format.
+     * Date format for display using [date-fns `format` token syntax](https://date-fns.org/v2.29.3/docs/format)
+     * (for example `yyyy`, `MM`, `dd`, `HH:mm:ss`, or `yy-MM`). This is **not** the ECMAScript Date Time String Format.
      *
-     * See [ECMAScript Date Time String Format](https://tc39.es/ecma262/multipage/numbers-and-dates.html#sec-date-time-string-format)
-     *
-     * Note that 'YYYY' and 'DD' have been disabled since they often get confused with 'yyyy' and 'dd'
-     * and can produce unexpected results.
+     * Note that `YYYY` and `DD` are discouraged since they are often confused with `yyyy` and `dd` and can produce
+     * unexpected results.
      */
     dateFormat?: string;
     /** Boolean flag to toggle continuous timeline on this date column. */
@@ -571,7 +570,7 @@ export type CommonDataOptions = ChartDataOptions | PivotTableDataOptions | Gener
 /**
  * Configuration for how to query aggregate data and assigning data to chart encodings of regular charts.
  */
-export type RegularChartDataOptions = CartesianChartDataOptions | CategoricalChartDataOptions | ScatterChartDataOptions | IndicatorChartDataOptions | BoxplotChartDataOptions | BoxplotChartCustomDataOptions | AreamapChartDataOptions | ScattermapChartDataOptions | RangeChartDataOptions | CalendarHeatmapChartDataOptions;
+export type RegularChartDataOptions = CartesianChartDataOptions | CategoricalChartDataOptions | ScatterChartDataOptions | IndicatorChartDataOptions | BoxplotChartDataOptions | BoxplotChartCustomDataOptions | AreamapChartDataOptions | ScattermapChartDataOptions | RangeChartDataOptions | CalendarHeatmapChartDataOptions | SankeyChartDataOptions;
 /** @internal */
 export interface CartesianChartDataOptionsInternal {
     x: StyledColumn[];
@@ -645,7 +644,7 @@ export interface PivotTableDataOptionsInternal {
     grandTotals?: PivotGrandTotals;
 }
 /** @internal */
-export type ChartDataOptionsInternal = CartesianChartDataOptionsInternal | CategoricalChartDataOptionsInternal | ScatterChartDataOptionsInternal | IndicatorChartDataOptionsInternal | BoxplotChartDataOptionsInternal | AreamapChartDataOptionsInternal | ScattermapChartDataOptionsInternal | RangeChartDataOptionsInternal | CalendarHeatmapChartDataOptionsInternal;
+export type ChartDataOptionsInternal = CartesianChartDataOptionsInternal | CategoricalChartDataOptionsInternal | ScatterChartDataOptionsInternal | IndicatorChartDataOptionsInternal | BoxplotChartDataOptionsInternal | AreamapChartDataOptionsInternal | ScattermapChartDataOptionsInternal | RangeChartDataOptionsInternal | CalendarHeatmapChartDataOptionsInternal | SankeyChartDataOptionsInternal;
 /** @internal */
 export type IndicatorChartDataOptionsInternal = {
     value?: StyledMeasureColumn[];
@@ -675,3 +674,43 @@ export type CalendarHeatmapChartDataOptionsInternal = {
     date: StyledColumn;
     value: StyledMeasureColumn;
 };
+/**
+ * Configuration for how to query aggregate data and assign data
+ * to a {@link SankeyChartType | Sankey chart}.
+ *
+ * @beta
+ *
+ * @example
+ * ```tsx
+ * <SankeyChart
+ *   dataSet={dataSource}
+ *   dataOptions={{
+ *     category: [DM.Commerce.Gender, DM.Commerce.AgeRange],
+ *     value: measureFactory.sum(DM.Commerce.Revenue),
+ *   }}
+ * />
+ * ```
+ */
+export interface SankeyChartDataOptions {
+    /**
+     * Columns (or attributes) representing the nodes in each stage of the flow.
+     * Must contain at least 2 items to define source and target nodes.
+     * When more than 2 items are provided the chart displays multi-stage flows.
+     */
+    category: (Column | CalculatedColumn | StyledColumn)[];
+    /**
+     * Measure column whose aggregated values determine the flow weight between nodes.
+     * Use a styled measure column to apply {@link StyledMeasureColumn.numberFormatConfig | number formatting}.
+     */
+    value: MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
+    /**
+     * Optional mapping of node names to colors.
+     */
+    seriesToColorMap?: ValueToColorMap | MultiColumnValueToColorMap;
+}
+/** @internal */
+export type SankeyChartDataOptionsInternal = {
+    category: StyledColumn[];
+    value: StyledMeasureColumn;
+    seriesToColorMap?: ValueToColorMap | MultiColumnValueToColorMap;
+};

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

@@ -64,6 +64,7 @@ export type SeriesType = HighchartsSeriesValues & {
     dashStyle?: string;
     lineWidth?: number;
     step?: boolean | 'left' | 'center' | 'right';
+    dataLabels?: DataLabelsSettings;
     zIndex?: number;
     keys?: string[];
     nullColor?: string;
@@ -148,6 +149,7 @@ export type PlotOptions = {
     scatter?: ChartPlotOptions;
     arearange?: ChartPlotOptions;
     heatmap?: ChartPlotOptions;
+    sankey?: ChartPlotOptions;
     streamgraph?: {
         lineWidth?: number;
         fillOpacity?: number;
@@ -179,6 +181,8 @@ export type HighchartsOptionsInternal = {
         spacing?: number[];
         marginTop?: number;
         alignTicks?: boolean;
+        /** When true, x and y axes are swapped (e.g. vertical Sankey). */
+        inverted?: boolean;
         polar: boolean;
         zoomType?: 'x' | 'y';
         scrollablePlotArea?: {

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

@@ -1,4 +1,4 @@
 import { ChartDataOptionsInternal } from '../chart-data-options/types';
 import { HighchartsDataPointContext, HighchartsDataPointContextNode, TooltipSettings } from './translations/tooltip-utils.js';
 export type { TooltipSettings, HighchartsDataPointContext, HighchartsDataPointContextNode };
-export declare const getCategoryTooltipSettings: (showDecimals: boolean | undefined, chartDataOptions: ChartDataOptionsInternal) => TooltipSettings;
+export declare const getCategoryTooltipSettings: (showDecimals: boolean | undefined, chartDataOptions: ChartDataOptionsInternal, defaultNumberFormattingEnabled?: boolean) => TooltipSettings;

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

@@ -1,5 +1,5 @@
 import { CalendarDayOfWeek } from '../../../../../domains/visualizations/components/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/utils';
-import { CalendarHeatmapSubtype, CalendarHeatmapViewType, Convolution, FunnelSeriesLabels, LegendOptions, LineOptions, PieSeriesLabels, ScattermapMarkers, SeriesLabels, SunburstStyleOptions, TotalLabels, TreemapStyleOptions } from '../../../../../types';
+import { CalendarHeatmapSubtype, CalendarHeatmapViewType, Convolution, FunnelSeriesLabels, LegendOptions, LineOptions, PieSeriesLabels, SankeyStyleOptions, ScattermapMarkers, SeriesLabels, SunburstStyleOptions, TotalLabels, TreemapStyleOptions } from '../../../../../types';
 import { Axis } from './axis-section';
 import { FunnelDirection, FunnelSize, FunnelType } from './funnel-plot-options';
 import { Marker } from './marker-section';
@@ -103,6 +103,15 @@ export type FunnelChartDesignOptions = Omit<BaseDesignOptionsType, 'seriesLabels
 };
 export type TreemapChartDesignOptions = BaseDesignOptionsType & TreemapStyleOptions;
 export type SunburstChartDesignOptions = BaseDesignOptionsType & SunburstStyleOptions;
+export type SankeyChartDesignOptions = BaseDesignOptionsType & {
+    /** Resolved flow direction from {@link SankeyStyleOptions.orientation} (defaults to horizontal). */
+    orientation?: 'horizontal' | 'vertical';
+    curveFactor?: SankeyStyleOptions['curveFactor'];
+    linkOpacity?: SankeyStyleOptions['linkOpacity'];
+    nodeWidth?: SankeyStyleOptions['nodeWidth'];
+    nodePadding?: SankeyStyleOptions['nodePadding'];
+    nodeAlignment?: SankeyStyleOptions['nodeAlignment'];
+};
 export type ScatterChartDesignOptions = BaseDesignOptionsType & {
     markerSize?: ScatterMarkerSize;
 };
@@ -163,6 +172,36 @@ export type TableDesignOptions = {
          * 'content' - columns width will be based on content (default option)
          */
         width?: 'auto' | 'content';
+        /**
+         * Enables interactive resizing of column widths by dragging the column border.
+         * Default value is `true`. Set to `false` to disable.
+         */
+        resizable?: boolean;
+        /**
+         * Minimum column width in pixels when resizing.
+         * Default value is 120.
+         */
+        minWidth?: number;
+        /**
+         * Maximum column width in pixels when resizing.
+         * Default value is 350.
+         */
+        maxWidth?: number;
+        /**
+         * Current column pixel widths, in display order. Set by the dashboarding
+         * layer to make column widths controlled/persisted; not intended for
+         * direct use.
+         *
+         * @internal
+         */
+        widths?: number[];
+        /**
+         * Fired with the full set of column widths (pixels, in display order)
+         * whenever a column resize completes.
+         *
+         * @internal
+         */
+        onColumnsResize?: (widths: number[]) => void;
     };
     /**
      * Rows options

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

@@ -46,4 +46,4 @@ export declare const DEFAULT_SHIFT = 50;
 export declare const funnelWidthPercentage: (renderTo: RenderTo | null) => number;
 export declare const funnelNeckWidth: (widthPercentage: number, funnelSize: FunnelSize) => number;
 export declare const funnelNeckHeight: (type: FunnelType) => number;
-export declare const getFunnelPlotOptions: (funnelDesignOptions: FunnelChartDesignOptions, chartDataOptions: ChartDataOptionsInternal) => PlotOptions;
+export declare const getFunnelPlotOptions: (funnelDesignOptions: FunnelChartDesignOptions, chartDataOptions: ChartDataOptionsInternal, defaultNumberFormattingEnabled?: boolean) => PlotOptions;

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

@@ -8,3 +8,15 @@ export declare const getCompleteNumberFormatConfig: (partialConfig?: NumberForma
 export declare const applyFormatStaticMarkup: (config: CompleteNumberFormatConfig, value: number) => string;
 export declare const applyFormat: (config: CompleteNumberFormatConfig, value: number) => string;
 export declare const applyFormatPlainText: (config: CompleteNumberFormatConfig, value: number) => string;
+/**
+ * Formats a number value, respecting the `defaultNumberFormatting.enabled` setting.
+ * Returns the formatted value when default formatting is enabled OR an explicit config is provided.
+ * Falls back to `String(value)` when default formatting is disabled and no explicit config exists.
+ *
+ * @param value - The numeric value to format.
+ * @param partialConfig - Optional explicit number format config set on the data option.
+ * @param isDefaultNumberFormattingEnabled - Whether default number formatting is active.
+ * @param formatter - Formatting function to use; defaults to `applyFormat`.
+ * @returns Formatted string when default formatting is enabled or an explicit config is provided; `String(value)` otherwise.
+ */
+export declare function formatNumberWithFallback(value: number, partialConfig: NumberFormatConfig | undefined, isDefaultNumberFormattingEnabled: boolean, formatter?: (config: CompleteNumberFormatConfig, value: number) => string): string;

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

@@ -35,6 +35,7 @@ export type GetPiePlotOptionsParams = {
     chartDataOptions: ChartDataOptionsInternal;
     themeSettings?: CompleteThemeSettingsInternal;
     semiCircle?: boolean;
+    defaultNumberFormattingEnabled?: boolean;
 };
-export declare const getPiePlotOptions: ({ pieType, seriesLabels, chartDataOptions, themeSettings, semiCircle, }: GetPiePlotOptionsParams) => PlotOptions;
+export declare const getPiePlotOptions: ({ pieType, seriesLabels, chartDataOptions, themeSettings, semiCircle, defaultNumberFormattingEnabled, }: GetPiePlotOptionsParams) => PlotOptions;
 export {};

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

@@ -3,7 +3,7 @@ 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?: CompleteThemeSettingsInternal): ({
+export declare function prepareSunburstLevels(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: SunburstChartDesignOptions, themeSettings?: CompleteThemeSettingsInternal, defaultNumberFormattingEnabled?: boolean): ({
     level: number;
     color: string;
     dataLabels: {
@@ -14,7 +14,7 @@ export declare function prepareSunburstLevels(chartData: CategoricalChartData, d
     };
     levelSize: {
         unit: string;
-        value: any;
+        value: 60 | 50 | 80 | 70;
     };
 } | {
     level: number;

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

@@ -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?: CompleteThemeSettingsInternal): ({
+export declare function prepareSunburstSeries(chartData: CategoricalChartData, dataOptions: CategoricalChartDataOptionsInternal, designOptions: SunburstChartDesignOptions, themeSettings?: CompleteThemeSettingsInternal, defaultNumberFormattingEnabled?: boolean): ({
     name: string;
     showInLegend: boolean;
     color: string;
@@ -27,7 +27,7 @@ export declare function prepareSunburstSeries(chartData: CategoricalChartData, d
             levelsCount: number;
         };
     } | {
-        color: any;
+        color: string | undefined;
         name?: string | undefined;
         y?: number | null | undefined;
         x?: number | null | undefined;
@@ -72,7 +72,7 @@ export declare function prepareSunburstSeries(chartData: CategoricalChartData, d
         };
         levelSize: {
             unit: string;
-            value: any;
+            value: 60 | 50 | 80 | 70;
         };
     } | {
         level: number;

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

@@ -10,7 +10,7 @@ export declare function prepareSunburstDataItems(chartData: CategoricalChartData
         levelsCount: number;
     };
 } | {
-    color: any;
+    color: string | undefined;
     name?: string | undefined;
     y?: number | null | undefined;
     x?: number | null | undefined;

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

@@ -7,6 +7,6 @@ type TooltipFormatterOptions = {
     displayColorCircles: boolean;
     shouldSkip: (context: HighchartsDataPointContext) => boolean;
 };
-export declare const getTreemapTooltipSettings: (chartDataOptions: CategoricalChartDataOptionsInternal, designOptions: TreemapChartDesignOptions, translate: TFunction, formatterOptions?: TooltipFormatterOptions) => TooltipSettings;
-export declare function treemapTooltipFormatter(context: HighchartsDataPointContext, chartDataOptions: CategoricalChartDataOptionsInternal, designOptions: TreemapChartDesignOptions, translate: TFunction, formatterOptions?: TooltipFormatterOptions): string | false;
+export declare const getTreemapTooltipSettings: (chartDataOptions: CategoricalChartDataOptionsInternal, designOptions: TreemapChartDesignOptions, translate: TFunction, formatterOptions?: TooltipFormatterOptions, defaultNumberFormattingEnabled?: boolean) => TooltipSettings;
+export declare function treemapTooltipFormatter(context: HighchartsDataPointContext, chartDataOptions: CategoricalChartDataOptionsInternal, designOptions: TreemapChartDesignOptions, translate: TFunction, formatterOptions?: TooltipFormatterOptions, defaultNumberFormattingEnabled?: boolean): string | false;
 export {};

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

@@ -1,7 +1,7 @@
 import { AreamapChartDesignOptions } from '../../../../../domains/visualizations/components/chart/restructured-charts/areamap-chart/types';
 import { StreamgraphChartDesignOptions } from '../../../../../domains/visualizations/components/chart/restructured-charts/highchart-based-charts/cartesians/stackable/streamgraph-chart/types';
 import { ChartType } from '../../../../../types';
-import { AreaChartDesignOptions, AreaRangeChartDesignOptions, BarChartDesignOptions, BaseDesignOptionsType, BoxplotChartDesignOptions, CalendarHeatmapChartDesignOptions, ColumnChartDesignOptions, FunnelChartDesignOptions, IndicatorChartDesignOptions, LineChartDesignOptions, PieChartDesignOptions, PolarChartDesignOptions, ScatterChartDesignOptions, ScattermapChartDesignOptions, SunburstChartDesignOptions, TreemapChartDesignOptions } from './design-options';
+import { AreaChartDesignOptions, AreaRangeChartDesignOptions, BarChartDesignOptions, BaseDesignOptionsType, BoxplotChartDesignOptions, CalendarHeatmapChartDesignOptions, ColumnChartDesignOptions, FunnelChartDesignOptions, IndicatorChartDesignOptions, LineChartDesignOptions, PieChartDesignOptions, PolarChartDesignOptions, SankeyChartDesignOptions, ScatterChartDesignOptions, ScattermapChartDesignOptions, SunburstChartDesignOptions, TreemapChartDesignOptions } from './design-options';
 /**
  * Style configuration for text elements in charts and UI components.
  * Defines the visual appearance and behavior of text rendering.
@@ -91,11 +91,19 @@ export type CalendarHeatmapChartType = (typeof CALENDAR_HEATMAP_CHART_TYPES)[num
 export declare const RANGE_CHART_TYPES: readonly ["arearange"];
 /** AreaRange chart types  @expandType */
 export type RangeChartType = (typeof RANGE_CHART_TYPES)[number];
+export declare const SANKEY_CHART_TYPES: readonly ["sankey"];
+/**
+ * Sankey chart types
+ *
+ * @expandType
+ * @beta
+ */
+export type SankeyChartType = (typeof SANKEY_CHART_TYPES)[number];
 export type ChartDataType = 'cartesian' | 'categorical' | 'scatter' | 'table' | 'indicator' | 'areamap' | 'arearange';
 /**
  * Design options for a specific chart type
  */
-export type DesignOptions<SpecificChartType extends ChartType = ChartType> = SpecificChartType extends 'line' ? LineChartDesignOptions : SpecificChartType extends 'area' ? AreaChartDesignOptions : SpecificChartType extends 'bar' ? BarChartDesignOptions : SpecificChartType extends 'column' ? ColumnChartDesignOptions : SpecificChartType extends 'streamgraph' ? StreamgraphChartDesignOptions : SpecificChartType extends 'pie' ? PieChartDesignOptions : SpecificChartType extends 'funnel' ? FunnelChartDesignOptions : SpecificChartType extends 'polar' ? PolarChartDesignOptions : SpecificChartType extends 'indicator' ? IndicatorChartDesignOptions : SpecificChartType extends 'scatter' ? ScatterChartDesignOptions : SpecificChartType extends 'treemap' ? TreemapChartDesignOptions : SpecificChartType extends 'sunburst' ? SunburstChartDesignOptions : SpecificChartType extends 'boxplot' ? BoxplotChartDesignOptions : SpecificChartType extends 'areamap' ? AreamapChartDesignOptions : SpecificChartType extends 'scattermap' ? ScattermapChartDesignOptions : SpecificChartType extends 'calendar-heatmap' ? CalendarHeatmapChartDesignOptions : SpecificChartType extends 'arearange' ? AreaRangeChartDesignOptions : never;
+export type DesignOptions<SpecificChartType extends ChartType = ChartType> = SpecificChartType extends 'line' ? LineChartDesignOptions : SpecificChartType extends 'area' ? AreaChartDesignOptions : SpecificChartType extends 'bar' ? BarChartDesignOptions : SpecificChartType extends 'column' ? ColumnChartDesignOptions : SpecificChartType extends 'streamgraph' ? StreamgraphChartDesignOptions : SpecificChartType extends 'pie' ? PieChartDesignOptions : SpecificChartType extends 'funnel' ? FunnelChartDesignOptions : SpecificChartType extends 'polar' ? PolarChartDesignOptions : SpecificChartType extends 'indicator' ? IndicatorChartDesignOptions : SpecificChartType extends 'scatter' ? ScatterChartDesignOptions : SpecificChartType extends 'treemap' ? TreemapChartDesignOptions : SpecificChartType extends 'sunburst' ? SunburstChartDesignOptions : SpecificChartType extends 'boxplot' ? BoxplotChartDesignOptions : SpecificChartType extends 'areamap' ? AreamapChartDesignOptions : SpecificChartType extends 'scattermap' ? ScattermapChartDesignOptions : SpecificChartType extends 'calendar-heatmap' ? CalendarHeatmapChartDesignOptions : SpecificChartType extends 'arearange' ? AreaRangeChartDesignOptions : SpecificChartType extends 'sankey' ? SankeyChartDesignOptions : never;
 /** A unique identifier for a series to be found in {@link ChartDataOptionsInternal} */
 type SeriesId = string;
 /**
@@ -123,6 +131,7 @@ export declare const isBoxplot: (chartType: ChartType) => chartType is "boxplot"
 export declare const isAreamap: (chartType: ChartType) => chartType is "areamap";
 export declare const isRange: (chartType: ChartType) => chartType is "arearange";
 export declare const isCalendarHeatmap: (chartType: ChartType) => chartType is "calendar-heatmap";
-export declare const ALL_CHART_TYPES: readonly ["line", "area", "bar", "column", "streamgraph", "polar", "pie", "funnel", "treemap", "sunburst", "scatter", "table", "indicator", "boxplot", "areamap", "image", "scattermap", "calendar-heatmap", "arearange"];
+export declare const isSankey: (chartType: ChartType) => chartType is "sankey";
+export declare const ALL_CHART_TYPES: readonly ["line", "area", "bar", "column", "streamgraph", "polar", "pie", "funnel", "treemap", "sunburst", "scatter", "table", "indicator", "boxplot", "areamap", "image", "scattermap", "calendar-heatmap", "arearange", "sankey"];
 export type DynamicChartType = (typeof ALL_CHART_TYPES)[number];
 export {};

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

@@ -55,10 +55,9 @@ export interface ChartWidgetProps extends ChartEventProps {
      */
     drilldownOptions?: DrilldownOptions;
     /**
-     * Widget configuration (e.g. header toolbar menu)
+     * Configuration of the widget
      *
      * @category Widget
-     * @internal
      */
     config?: WidgetConfig;
     /**

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

@@ -1,6 +1,6 @@
 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'> & {
+export type UseChartWidgetExcelDownloadParams = Pick<ChartWidgetProps, 'title' | 'dataOptions' | 'chartType' | 'config' | 'dataSource' | 'filters' | 'id'> & {
     baseHeaderConfig: WidgetHeaderConfig;
 };
 export type UseChartWidgetExcelDownloadResult = {
@@ -8,8 +8,7 @@ export type UseChartWidgetExcelDownloadResult = {
 };
 /**
  * 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`).
+ * Excel menu is shown only when the widget/dashboard allows download.
  * **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.

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

@@ -0,0 +1,28 @@
+import { type ReactNode } from 'react';
+import type { RefObject } from 'react';
+import type { ChartWidgetStyleOptions } from '../../../../types';
+import type { ChartWidgetProps } from './types';
+type UseChartWidgetNarrativeParams = {
+    propsWithDrilldown: ChartWidgetProps;
+    styleOptions: ChartWidgetStyleOptions | undefined;
+};
+type UseChartWidgetNarrativeReturn = {
+    /** Ref to pass to WidgetContainer — measures the content area for height constraints. */
+    contentAreaRef: RefObject<HTMLDivElement | null>;
+    /** styleOptions extended with the narrative trigger button injected into the header toolbar when applicable. */
+    styleOptionsWithNarrative: ChartWidgetStyleOptions | undefined;
+    /** Narrative element for the top slot; non-null only when displayLocation is `above` and narrative is visible. */
+    narrativeTopSlot: ReactNode;
+    /** Narrative element for the bottom slot; non-null only when displayLocation is `below` and narrative is visible. */
+    narrativeBottomSlot: ReactNode;
+    /** Narrative element used as widget content; non-null only when displayLocation is `alone` and narrative is visible. */
+    narrativeAloneContent: ReactNode;
+};
+/**
+ * Encapsulates all narrative-related logic for ChartWidget:
+ * options resolution, visibility state, trigger-button toolbar injection, and height constraints.
+ *
+ * @internal
+ */
+export declare function useChartWidgetNarrative({ propsWithDrilldown, styleOptions, }: UseChartWidgetNarrativeParams): UseChartWidgetNarrativeReturn;
+export {};

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

@@ -1,14 +1,14 @@
 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'> & {
+export type UseCustomWidgetExcelDownloadParams = Pick<CustomWidgetProps, 'title' | 'dataOptions' | 'filters' | '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`.
+ * Enhances a custom widget header with Excel download menu items when the widget/dashboard allows download.
+ * **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}

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

@@ -4,10 +4,10 @@ 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.
+ * space above the pivot — the container chrome (header + `spaceAround` padding) and
+ * the optional top slot (e.g. drilldown breadcrumbs, narrative-above). 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).

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

@@ -44,10 +44,9 @@ export interface PivotTableWidgetProps {
      */
     styleOptions?: PivotTableWidgetStyleOptions;
     /**
-     * Widget configuration (e.g. header toolbar menu)
+     * Configuration of the widget
      *
      * @category Widget
-     * @internal
      */
     config?: WidgetConfig;
     /**

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

@@ -1,6 +1,6 @@
 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'> & {
+export type UsePivotWidgetExcelDownloadParams = Pick<PivotTableWidgetProps, 'title' | 'dataOptions' | 'config' | 'dataSource' | 'filters' | 'id'> & {
     baseHeaderConfig: WidgetHeaderConfig;
 };
 export type UsePivotWidgetExcelDownloadResult = {
@@ -8,8 +8,7 @@ export type UsePivotWidgetExcelDownloadResult = {
 };
 /**
  * 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`).
+ * Excel menu is shown only when the widget/dashboard allows download.
  * **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.

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

@@ -1,3 +1,4 @@
+import type { WidgetNarrativeConfig } from '../../../../domains/narrative/core/widget-narrative-config';
 import type { BeforeMenuOpenHandler } from '../../../../infra/contexts/menu-provider/types';
 import type { WidgetHeaderConfig } from '../../shared/widget-header/types';
 import type { ChartWidgetProps } from '../chart-widget/types';
@@ -5,30 +6,41 @@ import type { CustomWidgetProps } from '../custom-widget/types';
 import type { PivotTableWidgetProps } from '../pivot-table-widget/types';
 import type { TextWidgetProps } from '../text-widget/types';
 /**
- * Generic widget configuration (e.g. header menu, toolbar, actions).
- * Shared across chart, pivot, text, and custom widgets.
+ * Configuration of the widget.
  */
 export type WidgetConfig = {
     /**
      * Configurations for the widget header (e.g. toolbar menu items)
+     *
+     * @alpha
      */
     header?: WidgetHeaderConfig;
     /**
-     * Configuration for widget actions.
-     *
-     * @sisenseInternal
+     * Configuration for actions available on the widget, such as
+     * downloading the widget's data.
      */
     actions?: {
         /**
-         * Configuration for downloading a CSV file.
+         * Configuration for the "Download as CSV" action, which adds an item to the
+         * widget's header menu that exports the widget's underlying data as a CSV file.
          *
-         * @sisenseInternal
+         * @example
+         * Enable CSV download for a widget:
+         * ```ts
+         * const widgetConfig: WidgetConfig = {
+         *   actions: {
+         *     downloadCsv: {
+         *       enabled: true,
+         *     },
+         *   },
+         * };
+         * ```
          */
         downloadCsv?: {
             /**
-             * Determines whether the possibility to download a CSV is enabled.
+             * Whether the "Download as CSV" action is enabled for the widget.
              *
-             * If not specified, the default value is `false`.
+             * @default false
              */
             enabled?: boolean;
         };
@@ -46,6 +58,10 @@ export type WidgetConfig = {
             enabled?: boolean;
         };
     };
+    /**
+     * Configuration for widget narrative.
+     */
+    narrative?: WidgetNarrativeConfig;
 };
 /**
  * Type of the widget component.

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

@@ -4783,6 +4783,7 @@ export declare function getDashboardFilters(dashboardFilters: Array<FilterDto |
         datasource?: import("@sisense/sdk-data").JaqlDataSource | undefined;
         title: string;
         level?: "years" | "quarters" | "months" | "weeks" | "days" | "minutes" | undefined;
+        dateTimePart?: "years" | "quarters" | "months" | "weeks" | "days" | "minutes" | "hours" | "seconds" | undefined;
         sort?: "desc" | "asc" | undefined;
         in?: {
             selected?: {