@sisense/sdk-ui 2.8.0 → 2.10.0

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

@@ -1,11 +1,10 @@
 import { ValueLabelOptions } from './value-label-section';
 import { Axis } from './axis-section';
 import { Marker } from './marker-section';
-import { LegendPosition } from './legend-section';
 import { LineType, StackType } from './translations-to-highcharts';
 import { PieType, PieLabels } from './pie-plot-options';
 import { FunnelSize, FunnelType, FunnelDirection, FunnelLabels } from './funnel-plot-options';
-import { Convolution, ScattermapMarkers, SunburstStyleOptions, TreemapStyleOptions } from '../../types';
+import { CalendarHeatmapViewType, Convolution, LineOptions, LegendOptions, ScattermapMarkers, SunburstStyleOptions, TreemapStyleOptions } from '../../types';
 import { ScatterMarkerSize } from './scatter-plot-options';
 import { DesignPerSeries } from './types';
 type DataLimits = {
@@ -13,9 +12,13 @@ type DataLimits = {
     categoriesCapacity: number;
 };
 export type BaseDesignOptionsType = {
-    legend: LegendPosition;
+    legend?: LegendOptions;
     valueLabel: ValueLabelOptions;
     lineType: LineType;
+    /**
+     * @deprecated
+     * Use line.width instead
+     */
     lineWidth: number;
     marker: Marker;
     xAxis: Axis;
@@ -33,17 +36,25 @@ export type BaseDesignOptionsType = {
 };
 export type CartesianChartDesignOptions = BaseDesignOptionsType & DesignPerSeries;
 export type StackableChartDesignOptions = CartesianChartDesignOptions & {
+    line?: LineOptions;
     stackType: StackType;
     showTotal?: boolean;
     totalLabelRotation?: number;
-} & DesignPerSeries;
+};
 export type LineChartDesignOptions = CartesianChartDesignOptions & {
     /** Step type for step line charts: left, center, or right */
     step?: 'left' | 'center' | 'right';
+    line?: LineOptions;
 };
 export type AreaChartDesignOptions = StackableChartDesignOptions;
 export type BarChartDesignOptions = StackableChartDesignOptions;
 export type ColumnChartDesignOptions = StackableChartDesignOptions;
+export type CalendarHeatmapChartDesignOptions = BaseDesignOptionsType & {
+    width?: number;
+    height?: number;
+    viewType: CalendarHeatmapViewType;
+    cellSize?: number;
+};
 export type PolarType = 'line' | 'area' | 'column';
 export type PolarChartDesignOptions = CartesianChartDesignOptions & {
     polarType: PolarType;
@@ -185,5 +196,8 @@ export type BoxplotChartDesignOptions = BaseDesignOptionsType & {
 export type ScattermapChartDesignOptions = BaseDesignOptionsType & {
     markers: Required<ScattermapMarkers>;
 };
-export type AreaRangeChartDesignOptions = BaseDesignOptionsType;
+export type AreaRangeChartDesignOptions = BaseDesignOptionsType & {
+    /** Configuration that defines line style */
+    line?: LineOptions;
+};
 export {};

package/dist/packages/sdk-ui/src/chart-options-processor/translations/legend-section.d.ts

@@ -1,28 +1,42 @@
-import { Style } from '../chart-options-service';
+import type { LegendOptions } from '../../types';
+import type { TextStyle } from './types';
 export type LegendPosition = 'top' | 'left' | 'right' | 'bottom' | null;
 export type LegendSettings = {
     enabled: boolean;
     align?: 'center' | 'left' | 'right';
     verticalAlign?: 'top' | 'middle' | 'bottom';
-    layout?: 'horizontal' | 'vertical';
-    itemStyle?: Style & {
-        cursor?: string;
-    };
-    symbolRadius?: number;
-    symbolHeight?: number;
-    symbolWidth?: number;
     borderWidth?: number;
     borderColor?: string;
+    borderRadius?: number;
     backgroundColor?: string;
+    margin?: number;
+    padding?: number;
+    maxHeight?: number;
+    shadow?: boolean;
+    reversed?: boolean;
+    rtl?: boolean;
+    floating?: boolean;
+    width?: number | string;
+    x?: number;
+    y?: number;
+    layout?: 'horizontal' | 'vertical' | 'proximate';
+    itemDistance?: number;
+    itemWidth?: number;
+    itemStyle?: TextStyle;
+    itemHoverStyle?: TextStyle;
+    itemHiddenStyle?: TextStyle;
     itemMarginBottom?: number;
     itemMarginTop?: number;
-    margin?: number;
+    symbolRadius?: number;
+    symbolHeight?: number;
+    symbolWidth?: number;
+    symbolPadding?: number;
+    squareSymbol?: boolean;
     title?: {
-        style?: {
-            [key: string]: string | number;
-        };
+        text?: string;
+        style?: TextStyle;
     };
-    maxHeight?: number;
 };
 export declare const legendItemStyleDefault: LegendSettings['itemStyle'];
-export declare const getLegendSettings: (position: LegendPosition) => LegendSettings;
+export declare const getLegendSettings: (legend?: LegendOptions) => LegendSettings;
+export declare const isLegendOnRight: (legend?: LegendOptions) => boolean;

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

@@ -1,18 +1,46 @@
-import { SeriesWithAlerts, CompleteThemeSettings } from '../../types';
+import { Convolution, SeriesWithAlerts, CompleteThemeSettings } from '../../types';
 import { CategoricalChartDataOptionsInternal } from '../../chart-data-options/types';
 import { SeriesType } from '../chart-options-service';
 import { PieChartDesignOptions } from './design-options';
 import { CategoricalChartData } from '../../chart-data/types';
+import { SeriesPieOptions } from '@sisense/sisense-charts';
 type FormattedPieChartData = SeriesWithAlerts<SeriesType[]> & {
-    convolutionSeries: SeriesType[];
+    convolutionSeries: SeriesPieOptions[];
 };
+/**
+ * Pure function that generates alerts for data limit warnings based on series capacity.
+ */
+export declare const getPieAlerts: (chartData: CategoricalChartData, seriesCapacity: number) => SeriesWithAlerts<SeriesType[]>['alerts'];
+/**
+ * Creates pie chart series with convolution applied.
+ * Returns the complete series ready for chart rendering.
+ */
+export declare const getPieSeries: ({ chartData, dataOptions, seriesCapacity, convolution, themeSettings, }: {
+    chartData: CategoricalChartData;
+    dataOptions: CategoricalChartDataOptionsInternal;
+    seriesCapacity: number;
+    convolution?: Convolution | undefined;
+    themeSettings?: CompleteThemeSettings | undefined;
+}) => SeriesType[];
+/**
+ * Returns only the convolution series (breakdown of "Others" slice).
+ * This is separate data for drill-down functionality.
+ */
+export declare const getPieConvolutionSeries: ({ chartData, dataOptions, seriesCapacity, convolution, themeSettings, }: {
+    chartData: CategoricalChartData;
+    dataOptions: CategoricalChartDataOptionsInternal;
+    seriesCapacity: number;
+    convolution?: Convolution | undefined;
+    themeSettings?: CompleteThemeSettings | undefined;
+}) => SeriesPieOptions[];
 /**
  * Convert categorical chart data into renderable highcharts pie series.
  *
- * @param chartData
- * @param dataOptions
- * @param designOptions
- * @param themeSettings
+ * @param chartData - The source categorical chart data
+ * @param dataOptions - Chart data configuration options
+ * @param designOptions - Design and styling options including convolution settings
+ * @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 {};

package/dist/packages/sdk-ui/src/chart-options-processor/translations/tooltip-utils.d.ts

@@ -54,6 +54,9 @@ export type HighchartsDataPointContext = {
             string1?: string;
             xDisplayValue?: string;
             xValue?: (number | string)[];
+            empty?: boolean;
+            monthDay?: number;
+            hasData?: boolean;
         };
         upperPointName?: string;
         lowerPointName?: string;
@@ -65,6 +68,8 @@ export type HighchartsDataPointContext = {
         };
         options?: TooltipFormatterContextObject['point']['options'];
         node?: HighchartsDataPointContextNode;
+        date?: string | number | Date;
+        value?: number;
     };
     percentage?: number;
     color?: string;

package/dist/packages/sdk-ui/src/chart-options-processor/translations/translations-to-highcharts.d.ts

@@ -7,7 +7,7 @@ import { Stacking } from '../chart-options-service';
 import { DesignOptions } from './types';
 export type LineType = 'straight' | 'smooth';
 export type StackType = 'classic' | 'stacked' | 'stack100';
-export type HighchartsType = ChartType | 'spline' | 'areaspline' | 'bubble';
+export type HighchartsType = ChartType | 'spline' | 'areaspline' | 'bubble' | 'heatmap';
 export type HighchartsSeriesValues = {
     name: string;
     data: SeriesPointStructure[];

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

@@ -1,6 +1,55 @@
 import { AreamapChartDesignOptions } from '../../chart/restructured-charts/areamap-chart/types';
 import { ChartType } from '../../types';
-import { LineChartDesignOptions, AreaChartDesignOptions, BarChartDesignOptions, ColumnChartDesignOptions, PieChartDesignOptions, FunnelChartDesignOptions, IndicatorChartDesignOptions, PolarChartDesignOptions, ScatterChartDesignOptions, TreemapChartDesignOptions, BoxplotChartDesignOptions, ScattermapChartDesignOptions, AreaRangeChartDesignOptions, BaseDesignOptionsType } from './design-options';
+import { LineChartDesignOptions, AreaChartDesignOptions, BarChartDesignOptions, ColumnChartDesignOptions, CalendarHeatmapChartDesignOptions, PieChartDesignOptions, FunnelChartDesignOptions, IndicatorChartDesignOptions, PolarChartDesignOptions, ScatterChartDesignOptions, TreemapChartDesignOptions, BoxplotChartDesignOptions, ScattermapChartDesignOptions, AreaRangeChartDesignOptions, BaseDesignOptionsType } from './design-options';
+/**
+ * Style configuration for text elements in charts and UI components.
+ * Defines the visual appearance and behavior of text rendering.
+ */
+export type TextStyle = {
+    /**
+     * Font family name for the text.
+     * Examples: 'Arial', 'Helvetica', 'Times New Roman', 'sans-serif'
+     */
+    fontFamily?: string;
+    /**
+     * Font size in CSS units (px, em, rem, pt, etc.).
+     * Examples: '12px', '1.2em', '16pt'
+     */
+    fontSize?: string;
+    /**
+     * Font weight for text rendering.
+     * Examples: 'normal', 'bold', '100', '200', '300', '400', '500', '600', '700', '800', '900'
+     */
+    fontWeight?: string;
+    /**
+     * Font style for text rendering.
+     * Examples: 'normal', 'italic', 'oblique'
+     */
+    fontStyle?: string;
+    /**
+     * Text color in any valid CSS color format.
+     * Examples: '#FF0000', 'rgb(255, 0, 0)', 'red', 'rgba(255, 0, 0, 0.5)'
+     */
+    color?: string;
+    /**
+     * Text outline/stroke configuration.
+     * Defines the outline color and width for text rendering.
+     * Examples: '1px solid black', '2px #333'
+     */
+    textOutline?: string;
+    /**
+     * CSS pointer-events property for text interaction.
+     * Controls how the text responds to mouse events.
+     * Examples: 'auto', 'none', 'visible', 'visibleFill', 'visibleStroke'
+     */
+    pointerEvents?: string;
+    /**
+     * Text overflow handling behavior.
+     * Controls how text is displayed when it exceeds its container.
+     * Examples: 'clip', 'ellipsis', 'visible', 'hidden'
+     */
+    textOverflow?: string;
+};
 export declare const POLAR_CHART_TYPES: readonly ["polar"];
 export type PolarChartType = (typeof POLAR_CHART_TYPES)[number];
 export declare const CARTESIAN_CHART_TYPES: readonly ["line", "area", "bar", "column", "polar"];
@@ -31,6 +80,14 @@ export type ImageChartType = (typeof IMAGE_CHART_TYPES)[number];
 export declare const SCATTERMAP_CHART_TYPES: readonly ["scattermap"];
 /** Scattermap chart types  @expandType */
 export type ScattermapChartType = (typeof SCATTERMAP_CHART_TYPES)[number];
+export declare const CALENDAR_HEATMAP_CHART_TYPES: readonly ["calendar-heatmap"];
+/**
+ * Calendar heatmap chart types
+ *
+ * @expandType
+ * @alpha
+ */
+export type CalendarHeatmapChartType = (typeof CALENDAR_HEATMAP_CHART_TYPES)[number];
 export declare const RANGE_CHART_TYPES: readonly ["arearange"];
 /** AreaRange chart types  @expandType */
 export type RangeChartType = (typeof RANGE_CHART_TYPES)[number];
@@ -38,7 +95,7 @@ export type ChartDataType = 'cartesian' | 'categorical' | 'scatter' | 'table' |
 /**
  * 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 'pie' ? PieChartDesignOptions : SpecificChartType extends 'funnel' ? FunnelChartDesignOptions : SpecificChartType extends 'polar' ? PolarChartDesignOptions : SpecificChartType extends 'indicator' ? IndicatorChartDesignOptions : SpecificChartType extends 'scatter' ? ScatterChartDesignOptions : SpecificChartType extends 'treemap' ? TreemapChartDesignOptions : SpecificChartType extends 'boxplot' ? BoxplotChartDesignOptions : SpecificChartType extends 'areamap' ? AreamapChartDesignOptions : SpecificChartType extends 'scattermap' ? ScattermapChartDesignOptions : 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 'pie' ? PieChartDesignOptions : SpecificChartType extends 'funnel' ? FunnelChartDesignOptions : SpecificChartType extends 'polar' ? PolarChartDesignOptions : SpecificChartType extends 'indicator' ? IndicatorChartDesignOptions : SpecificChartType extends 'scatter' ? ScatterChartDesignOptions : SpecificChartType extends 'treemap' ? TreemapChartDesignOptions : SpecificChartType extends 'boxplot' ? BoxplotChartDesignOptions : SpecificChartType extends 'areamap' ? AreamapChartDesignOptions : SpecificChartType extends 'scattermap' ? ScattermapChartDesignOptions : SpecificChartType extends 'calendar-heatmap' ? CalendarHeatmapChartDesignOptions : SpecificChartType extends 'arearange' ? AreaRangeChartDesignOptions : never;
 /** A unique identifier for a series to be found in {@link ChartDataOptionsInternal} */
 type SeriesId = string;
 /**
@@ -51,7 +108,7 @@ export type ChartDesignOptions<SpecificChartType extends ChartType = ChartType>
  *
  * @internal
  */
-export type SeriesDesignOptions = Pick<BaseDesignOptionsType, 'lineWidth' | 'marker'>;
+export type SeriesDesignOptions = Pick<BaseDesignOptionsType, 'marker'> & Pick<LineChartDesignOptions, 'line'>;
 export type DesignPerSeries = {
     designPerSeries: Record<SeriesId, SeriesDesignOptions>;
 };
@@ -65,6 +122,6 @@ export declare const isTable: (chartType: ChartType | TableType) => chartType is
 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 ALL_CHART_TYPES: readonly ["line", "area", "bar", "column", "polar", "pie", "funnel", "treemap", "sunburst", "scatter", "table", "indicator", "boxplot", "areamap", "image", "scattermap", "arearange"];
+export declare const ALL_CHART_TYPES: readonly ["line", "area", "bar", "column", "polar", "pie", "funnel", "treemap", "sunburst", "scatter", "table", "indicator", "boxplot", "areamap", "image", "scattermap", "calendar-heatmap", "arearange"];
 export type DynamicChartType = (typeof ALL_CHART_TYPES)[number];
 export {};

package/dist/packages/sdk-ui/src/chart-options-processor/translations/value-label-section.d.ts

@@ -1,5 +1,5 @@
 import type { DataLabelsOptions } from '@sisense/sisense-charts';
-import { Style } from '../chart-options-service';
+import { TextStyle } from './types';
 import { AxisOrientation } from './axis-section';
 import { HighchartsDataPointContext } from './tooltip-utils';
 import { PolarType } from './design-options';
@@ -18,7 +18,7 @@ export type ValueLabelSettings = {
     rotation?: number;
     y?: number;
     x?: number;
-    style?: Style;
+    style?: TextStyle;
     overflow?: string;
     allowOverlap?: boolean;
     verticalAlign?: 'bottom' | 'middle' | 'top';

package/dist/packages/sdk-ui/src/common/formatters/create-date-formatter.d.ts

@@ -0,0 +1,10 @@
+import { DateConfig } from '../../query/date-formats';
+export type DateFormatter = (date: Date, format: string) => string;
+/**
+ * Creates a date formatter function
+ *
+ * @param locale - The locale to use for formatting
+ * @param cfg - The date configuration to use for formatting
+ * @returns A function that formats dates
+ */
+export declare function createDateFormatter(locale?: Locale, cfg?: DateConfig): DateFormatter;

package/dist/packages/sdk-ui/src/common/hooks/useDateFormatter.d.ts

@@ -0,0 +1,7 @@
+import { DateFormatter } from '../formatters/create-date-formatter';
+/**
+ * A hook that returns a date formatter function
+ *
+ * @returns A function that formats dates
+ */
+export declare function useDateFormatter(): DateFormatter;

package/dist/packages/sdk-ui/src/common/icons/double-arrow-end-icon.d.ts

@@ -0,0 +1,6 @@
+import { Themable } from '../../theme-provider/types';
+import type { SVGProps } from 'react';
+export declare const DoubleArrowEndIcon: (props: Pick<SVGProps<SVGElement>, 'className' | 'width' | 'height' | 'fill' | 'onClick'> & {
+    direction: 'left' | 'right';
+    disabled?: boolean;
+} & Themable) => import("react/jsx-runtime").JSX.Element;

package/dist/packages/sdk-ui/src/const.d.ts

@@ -3,3 +3,5 @@ export declare const SYSTEM_TENANT_NAME = "system";
 export declare const DEFAULT_TEXT_COLOR = "#5B6372";
 export declare const DEFAULT_BACKGROUND_COLOR = "#F4F4F8";
 export declare const ERROR_COLOR = "#FA5656";
+export declare const NOT_AVAILABLE_DATA_VALUE = "N\\A";
+export declare const NOT_AVAILABLE_TEXT = "N/A";

package/dist/packages/sdk-ui/src/dashboard/components/editable-layout/utils.d.ts

@@ -1,24 +1,5 @@
 import { EditableLayoutDragData, EditableLayoutDropData } from '../../../dashboard/components/editable-layout/types';
 import { DragStartEvent } from '@dnd-kit/core';
-import { RenderTitleHandler, RenderToolbarHandler, TextWidgetRenderToolbarHandler } from '../../../types';
 export declare const isEditableLayoutDragData: (data: any | undefined) => data is EditableLayoutDragData;
 export declare const isEditableLayoutDropData: (data: any) => data is EditableLayoutDropData;
 export declare const getDraggingWidgetId: (event: DragStartEvent) => string | null;
-/**
- * Compose multiple RenderToolbarHandler functions into one.
- * Each handler gets a chance to modify the toolbar.
- * If it returns `null`, the previous toolbar is passed to the next handler.
- */
-export declare function composeToolbarHandlers(...handlers: (RenderToolbarHandler | undefined)[]): RenderToolbarHandler;
-/**
- * Compose multiple TextWidgetRenderToolbarHandler functions into one.
- * Each handler gets a chance to modify the toolbar.
- * If it returns `null`, the previous toolbar is passed to the next handler.
- */
-export declare function composeTextWidgetToolbarHandlers(...handlers: (TextWidgetRenderToolbarHandler | undefined)[]): TextWidgetRenderToolbarHandler;
-/**
- * Compose multiple RenderTitleHandler functions into one.
- * Each handler gets a chance to modify the title.
- * If it returns `null`, the previous tile is passed to the next handler.
- */
-export declare function composeTitleHandlers(...handlers: (RenderTitleHandler | undefined)[]): RenderTitleHandler;

package/dist/packages/sdk-ui/src/dashboard/hooks/jtd/index.d.ts

@@ -1,5 +1,5 @@
 export { getFiltersFromDataPoint, getFormulaContextFilters, filterByAllowedDimensions, handleFormulaDuplicateFilters, mergeJtdFilters, } from './jtd-filters';
 export { getJtdClickHandler, getJtdClickHandlerForMultiplePoints, handleDataPointClick, handleTextWidgetClick, } from './jtd-handlers';
 export { getJumpToDashboardMenuItem, getJumpToDashboardMenuItemForMultiplePoints, } from './jtd-menu';
-export { addPointerCursorToChart, applyClickNavigationForChart, applyClickNavigationForText, applyRightClickNavigation, addJtdIconToHeader, } from './jtd-widget-transforms';
+export { addPointerCursorToChart, applyClickNavigationForChart, applyClickNavigationForText, applyClickNavigationForPivot, applyRightClickNavigation, applyRightClickNavigationForPivot, applyPivotLinkStyling, addJtdIconToHeader, } from './jtd-widget-transforms';
 export { type JtdCoreData, type JtdContext, type JtdActions, type JtdClickHandlerData, type JtdWidgetTransformConfig, type JtdDataPointClickEvent, type JtdMenuItem, } from './jtd-types';

package/dist/packages/sdk-ui/src/dashboard/hooks/jtd/jtd-filters.d.ts

@@ -10,7 +10,7 @@ import { JtdConfig } from '../../../widget-by-id/types';
  * 1. **Generated Filters**: Created from the clicked datapoint's category and breakBy entries
  * 2. **Dashboard Filters**: Current dashboard filters (filtered by includeDashFilterDims)
  * 3. **Widget Filters**: Original widget-specific filters (filtered by includeWidgetFilterDims)
- * 4. **Formula Context Filters**: NEW - Embedded filters from the clicked widget's datapoint calculations
+ * 4. **Formula Context Filters**: Embedded filters from the clicked widget's datapoint calculations
  *
  * ## Formula Context Filters (New Feature)
  *
@@ -68,6 +68,17 @@ export declare const getFormulaContextFilters: (clickedWidget: WidgetProps, jtdC
  * @internal
  */
 export declare const handleFormulaDuplicateFilters: (filters: Filter[], sendFormulaFiltersDuplicate?: number | 'none') => Filter[];
+/**
+ * Normalizes a date value to the start of the period for the given granularity
+ * This ensures the filter member value matches what the backend query returns
+ * Uses existing date utilities instead of manual parsing to reduce business logic
+ *
+ * @param value - The raw date value (e.g., "2009-11-15T12:30:00.000")
+ * @param granularity - The date granularity (e.g., "Months")
+ * @returns Normalized date string that matches backend member query format
+ * @internal
+ */
+export declare const normalizeDateForGranularity: (value: string, granularity: string) => string;
 /**
  * Type guard to check if a data point is a ScatterDataPoint.
  * Checks for actual scatter chart structure (x/y coordinates) and scatter-only properties.

package/dist/packages/sdk-ui/src/dashboard/hooks/jtd/jtd-formatters.d.ts

@@ -0,0 +1,18 @@
+import type { CustomDataCellFormatter, CustomHeaderCellFormatter } from '../../../pivot-table/formatters/types';
+import { JtdConfig } from '../../../widget-by-id/types';
+/**
+ * Creates a data cell formatter that applies hyperlink styling for JTD navigation
+ *
+ * @param hyperlinkColor - The color to use for hyperlink text (uses theme's hyperlinkColor
+ * @returns Data cell formatter function
+ * @internal
+ */
+export declare function createJtdHyperlinkDataCellFormatter(hyperlinkColor: string, jtdConfig: JtdConfig): CustomDataCellFormatter;
+/**
+ * Creates a header cell formatter that applies hyperlink styling for JTD navigation
+ *
+ * @param hyperlinkColor - The color to use for hyperlink text (uses theme's hyperlinkColor or defaults to DEFAULT_HYPERLINK_COLOR)
+ * @param jtdConfig - JTD configuration containing drill targets
+ * @returns A header cell formatter that applies hyperlink styling to matching header cells
+ */
+export declare function createJtdHyperlinkHeaderCellFormatter(hyperlinkColor: string, jtdConfig: JtdConfig): CustomHeaderCellFormatter;

package/dist/packages/sdk-ui/src/dashboard/hooks/jtd/jtd-handlers.d.ts

@@ -1,5 +1,6 @@
 import { type Filter } from '@sisense/sdk-data';
 import { WidgetProps } from '../../../props.js';
+import { PivotTableDataPoint, DataPoint } from '../../../types';
 import { JtdConfig } from '../../../widget-by-id/types';
 import { OpenModalFn } from '../../../common/components/modal/modal-context';
 import { JtdCoreData, JtdContext, JtdActions, JtdClickHandlerData, JtdDataPointClickEvent } from './jtd-types';
@@ -33,6 +34,28 @@ export declare const getJtdClickHandlerForMultiplePoints: (data: JtdClickHandler
  * @internal
  */
 export declare const handleDataPointClick: (coreData: JtdCoreData, context: JtdContext, actions: Pick<JtdActions, 'openModal' | 'openMenu' | 'translate'>, event: JtdDataPointClickEvent) => void | Promise<string>;
+/**
+ * Convert PivotTableDataPoint to DataPoint format for JTD processing
+ *
+ * @param pivotPoint - The pivot table data point
+ * @returns Converted data point
+ * @internal
+ */
+export declare const convertPivotToDataPoint: (pivotPoint: PivotTableDataPoint) => DataPoint;
+/**
+ * Handle pivot table data point click
+ *
+ * @param data - Core data with drill target (config, drill target, widget props, pivot point)
+ * @param context - Context data (filters)
+ * @param actions - Action functions
+ * @param eventData - Event-related data
+ * @internal
+ */
+export declare const handlePivotDataPointClick: (data: {
+    jtdConfig: JtdConfig;
+    widgetProps: WidgetProps;
+    point: PivotTableDataPoint;
+}, context: JtdContext, actions: Pick<JtdActions, 'openModal' | 'openMenu' | 'translate'>) => Promise<string> | undefined;
 /**
  * Handle text widget click (placeholder for future implementation)
  *

package/dist/packages/sdk-ui/src/dashboard/hooks/jtd/jtd-widget-transforms.d.ts

@@ -18,6 +18,16 @@ export declare const addPointerCursorToChart: (widgetProps: WidgetProps) => Widg
  * @internal
  */
 export declare const applyClickNavigationForChart: (widgetProps: WidgetProps, config: JtdWidgetTransformConfig, actions: Pick<JtdActions, 'openModal' | 'openMenu' | 'translate'>) => WidgetProps;
+/**
+ * Apply JTD click navigation for pivot table widgets
+ *
+ * @param widgetProps - The widget props
+ * @param config - The JTD configuration and context
+ * @param actions - The action functions
+ * @returns Updated widget props with click navigation
+ * @internal
+ */
+export declare const applyClickNavigationForPivot: (widgetProps: WidgetProps, config: JtdWidgetTransformConfig, actions: Pick<JtdActions, 'openModal' | 'openMenu' | 'translate'>) => WidgetProps;
 /**
  * Apply JTD click navigation for text widgets
  *
@@ -38,6 +48,25 @@ export declare const applyClickNavigationForText: (widgetProps: WidgetProps, con
  * @internal
  */
 export declare const applyRightClickNavigation: (widgetProps: WidgetProps, config: JtdWidgetTransformConfig, actions: Pick<JtdActions, 'openModal' | 'openMenu' | 'translate'>) => WidgetProps;
+/**
+ * Apply JTD right-click navigation for pivot table widgets
+ *
+ * @param widgetProps - The widget props
+ * @param config - The JTD configuration and context
+ * @param actions - The action functions
+ * @returns Updated widget props with right-click navigation
+ * @internal
+ */
+export declare const applyRightClickNavigationForPivot: (widgetProps: WidgetProps, config: JtdWidgetTransformConfig, actions: Pick<JtdActions, 'openModal' | 'openMenu' | 'translate'>) => WidgetProps;
+/**
+ * Applies hyperlink styling to pivot table cells for PIVOT_LINK navigation
+ * @param widgetProps - Pivot table widget props
+ * @param config - JTD configuration
+ * @param hyperlinkColor
+ * @returns Updated widget props with hyperlink styling
+ * @internal
+ */
+export declare const applyPivotLinkStyling: (widgetProps: WidgetProps, config: JtdWidgetTransformConfig, hyperlinkColor?: string) => WidgetProps;
 /**
  * Add JTD icon to widget header if configured
  *

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

@@ -37,6 +37,7 @@ export * from './boxplot-chart';
 export * from './scattermap-chart';
 export * from './areamap-chart';
 export * from './area-range-chart';
+export * from './calendar-heatmap-chart';
 export * from './sisense-context/custom-sisense-context-provider';
 export * from './theme-provider/custom-theme-provider';
 export * from './custom-widgets-provider/custom-widgets-provider-adapter';

package/dist/packages/sdk-ui/src/models/dashboard/translate-dashboard-utils.d.ts

@@ -5,6 +5,7 @@ import { WidgetDto } from '../../widget-by-id/types';
 import { RestApi } from '../../api/rest-api';
 export declare const translateLayout: (layout: LayoutDto) => WidgetsPanelColumnLayout;
 export declare function extractDashboardFilters(dashboardFilters: Array<FilterDto | CascadingFilterDto>, filterRelationsModel?: FilterRelationsModel | FilterRelationsModelNode): Filter[] | FilterRelations;
+export declare const convertDimensionsToDimIndexes: (widget: WidgetDto, dimensionIds: string[]) => string[];
 export declare function translateWidgetsOptions(widgets?: WidgetDto[]): WidgetsOptions;
 export declare function translateTabbersOptions(widgets?: WidgetDto[]): TabbersOptions;
 /**

package/dist/packages/sdk-ui/src/pivot-table/formatters/data-cell-formatters/index.d.ts

@@ -1 +1,2 @@
 export { createDataCellValueFormatter } from './data-cell-value-formatter.js';
+export { createDataCellColorFormatter } from './data-cell-color-formatter.js';

package/dist/packages/sdk-ui/src/pivot-table/formatters/formatter-utils.d.ts

@@ -0,0 +1,23 @@
+import type { CustomDataCellFormatter, CustomHeaderCellFormatter, CellFormattingResult } from './types.js';
+import type { JaqlPanel, PivotDataNode, PivotTreeNode } from '@sisense/sdk-pivot-client';
+import type { PivotTableDataOptionsInternal } from '../../chart-data-options/types';
+/**
+ * Applies a formatting result to a data cell, mutating the cell object
+ * @param cell - The cell to apply formatting to
+ * @param result - The formatting result to apply
+ */
+export declare function applyCellFormattingResult(cell: PivotDataNode | PivotTreeNode, result: CellFormattingResult): void;
+/**
+ * Creates a unified formatter that handles functional formatters by applying their results
+ *
+ * @param formatter - A functional formatter that returns formatting information
+ * @returns A function that applies the formatter result to the cell
+ */
+export declare function createUnifiedDataCellFormatter(formatter: CustomDataCellFormatter, dataOptions: PivotTableDataOptionsInternal): (cell: PivotDataNode, rowItem: PivotTreeNode, columnItem: PivotTreeNode, jaqlPanelItem: JaqlPanel) => void;
+/**
+ * Creates a unified header cell formatter that handles functional formatters by applying their results
+ *
+ * @param formatter - A functional header formatter that returns formatting information
+ * @returns A function that applies the formatter result to the header cell
+ */
+export declare function createUnifiedHeaderCellFormatter(formatter: CustomHeaderCellFormatter, dataOptions: PivotTableDataOptionsInternal): (cell: PivotTreeNode, jaqlPanelItem: JaqlPanel | undefined) => void;

package/dist/packages/sdk-ui/src/pivot-table/formatters/header-cell-formatters/header-cell-value-formatter.d.ts

@@ -1,5 +1,6 @@
 import type { PivotTableDataOptions } from '../../../chart-data-options/types.js';
-import type { DateFormatter, HeaderCellFormatter } from '../types.js';
+import type { HeaderCellFormatter } from '../types.js';
+import { DateFormatter } from '../../../common/formatters/create-date-formatter.js';
 export declare const createHeaderCellValueFormatter: (dataOptions: PivotTableDataOptions, dateFormatter: DateFormatter) => HeaderCellFormatter;
 /**
  * Formats the date time string or Date object.

package/dist/packages/sdk-ui/src/pivot-table/formatters/types.d.ts

@@ -1,4 +1,46 @@
+/// <reference types="react" />
 import type { JaqlPanel, JaqlRequest, PivotDataNode, PivotTreeNode } from '@sisense/sdk-pivot-client';
-export type DataCellFormatter = (cell: PivotDataNode, rowItem: PivotTreeNode, columnItem: PivotTreeNode, jaqlPanelItem: JaqlPanel) => void;
-export type HeaderCellFormatter = (cell: PivotTreeNode, jaqlPanelItem: JaqlPanel, jaql: JaqlRequest) => void;
-export type DateFormatter = (date: Date, format: string) => string;
+import { AnyColumn } from '../../chart-data-options/types';
+/**
+ * Formatting result that can be applied to a header cell
+ */
+export interface CellFormattingResult {
+    /** Text content to display in the cell */
+    content?: string;
+    /** Inline styles to apply to the cell */
+    style?: React.CSSProperties;
+}
+/**
+ * Data cell formatter that returns formatting information instead of mutating parameters
+ */
+export type DataCellFormatter = (cell: PivotDataNode, rowItem: PivotTreeNode, columnItem: PivotTreeNode, jaqlPanelItem: JaqlPanel) => CellFormattingResult | void;
+/**
+ * Applies custom formatting to pivot table data cells.
+ *
+ * This function is called for each data cell in the pivot table and can return
+ * formatting information to customize the cell's appearance and behavior.
+ *
+ * @param cell - The pivot data cell being formatted
+ * @param jaqlPanelItem - JAQL panel metadata for the cell
+ * @param dataOption - The data option configuration for this cell
+ * @param id - Unique identifier for the data option
+ * @returns Formatting result object or void to skip formatting
+ */
+export type CustomDataCellFormatter = (cell: PivotDataNode, jaqlPanelItem: JaqlPanel, dataOption: AnyColumn, id: string) => CellFormattingResult | void;
+/**
+ * Header cell formatter that returns formatting information instead of mutating parameters
+ */
+export type HeaderCellFormatter = (cell: PivotTreeNode, jaqlPanelItem: JaqlPanel, jaql: JaqlRequest) => CellFormattingResult | void;
+/**
+ * Applies custom formatting to pivot table header cells.
+ *
+ * This function is called for each row and column header cell in the pivot table
+ * and can return formatting information to customize the header's appearance and behavior.
+ *
+ * @param cell - The pivot header cell being formatted
+ * @param jaqlPanelItem - JAQL panel metadata for the cell (may be undefined for certain header types)
+ * @param dataOption - The data option configuration for this cell (optional)
+ * @param id - Unique identifier for the data option (optional)
+ * @returns Formatting result object or void to skip formatting
+ */
+export type CustomHeaderCellFormatter = (cell: PivotTreeNode, jaqlPanelItem: JaqlPanel | undefined, dataOption?: AnyColumn, id?: string) => CellFormattingResult | void;

package/dist/packages/sdk-ui/src/pivot-table/formatters/utils.d.ts

@@ -1,5 +1,6 @@
 import { type Column } from '@sisense/sdk-data';
 import { type PivotTableDataOptions, type StyledColumn, type AnyColumn } from '../../chart-data-options/types';
 export declare const getPivotDataOptionByJaqlIndex: (dataOptions: PivotTableDataOptions, dataOptionIndex?: number) => AnyColumn | undefined;
+export declare const getPivotDataOptionIdByJaqlIndex: (dataOptions: PivotTableDataOptions, dataOptionIndex?: number) => string | undefined;
 export declare const getNumberFormatConfig: (dataOption?: AnyColumn) => Required<import("../..").NumberFormatConfig>;
 export declare const getDateFormatConfig: (dataOption: Column | StyledColumn) => string | undefined;