@sisense/sdk-ui 2.7.0 → 2.9.0

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/icons/drag-handle-icon.d.ts

@@ -1,3 +1,4 @@
-export declare const DragHandleIcon: ({ color }: {
+export declare const DragHandleIcon: ({ color, ...props }: {
+    [x: string]: any;
     color?: string | undefined;
 }) => 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/custom-widgets-provider/types.d.ts

@@ -7,7 +7,16 @@ import { GenericDataOptions } from '../types';
 export interface CustomWidgetComponentProps<DataOptions = GenericDataOptions, StyleOptions = any> {
     dataSource?: DataSource;
     dataOptions: DataOptions;
-    styleOptions: StyleOptions;
+    styleOptions: StyleOptions & {
+        /**
+         * The width of the custom widget component.
+         */
+        width?: number;
+        /**
+         * The height of the custom widget component.
+         */
+        height?: number;
+    };
     filters?: Filter[] | FilterRelations;
     highlights?: Filter[];
     description?: string;

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

@@ -14,11 +14,15 @@ type DraggableLineProps = {
      * The orientation of the draggable line
      */
     orientation?: DraggableLineOrientation;
+    /**
+     * The aria-label of the draggable line
+     */
+    ariaLabel?: string;
 };
 /**
  * Renders a draggable line component that can be used to resize columns or rows
  *
  * @internal
  */
-export declare const DraggableLine: ({ id, orientation }: DraggableLineProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DraggableLine: ({ id, orientation, ariaLabel, }: DraggableLineProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/packages/sdk-ui/src/dashboard/hooks/use-dashboard-header-toolbar.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 export interface DashboardHeaderToolbarMenuItem {
     title: string;
     icon?: JSX.Element;

package/dist/packages/sdk-ui/src/dashboard/hooks/use-edit-mode-toolbar.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { WidgetsPanelLayout } from '../../models';
 /**
  * Props for the useEditModeToolbar hook

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

@@ -23,6 +23,8 @@ export declare const useDashboardThemeInternal: ({ styleOptions }: DashboardThem
                 primaryTextColor: string;
                 secondaryTextColor: string;
                 backgroundColor: string;
+                dividerLineColor: string;
+                dividerLineWidth: number;
             };
         };
         palette?: import("..").ColorPaletteTheme | undefined;
@@ -47,6 +49,8 @@ export declare const useDashboardTheme: (args_0: DashboardThemeParams) => {
                 primaryTextColor: string;
                 secondaryTextColor: string;
                 backgroundColor: string;
+                dividerLineColor: string;
+                dividerLineWidth: number;
             };
         };
         palette?: import("..").ColorPaletteTheme | undefined;

package/dist/packages/sdk-ui/src/error-boundary/error-boundary.d.ts

@@ -36,6 +36,6 @@ export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBo
     };
     componentDidCatch(error: Error): void;
     componentDidUpdate(prevProps: ErrorBoundaryProps, prevState: ErrorBoundaryState): void;
-    render(): string | number | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | null | undefined;
+    render(): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
 }
 export {};

package/dist/packages/sdk-ui/src/filters/components/filters-panel/hooks/use-existing-filter-editing.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { Filter, DataSource } from '@sisense/sdk-data';
 import type { UseExistingFilterEditingConfig } from '../types';
 type UseExistingFilterEditingParams = {

package/dist/packages/sdk-ui/src/filters/components/filters-panel/hooks/use-new-filter-adding.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { DataSource, Filter } from '@sisense/sdk-data';
 import { UseNewFilterCreationConfig } from '../types';
 import { AttributiveElement } from '../../../../data-browser/dimensions-browser/types';

package/dist/packages/sdk-ui/src/filters/components/member-filter-tile/use-members.d.ts

@@ -9,6 +9,6 @@ interface Props {
 export declare const useMembers: ({ initialMembers, initialSelectedMembers, onUpdateSelectedMembers, disabled, }: Props) => {
     members: Member[];
     selectedMembers: import("./members-reducer").SelectedMember[];
-    dispatch: import("react").Dispatch<import("./members-reducer").MembersAction>;
+    dispatch: import("react").ActionDispatch<[action: import("./members-reducer").MembersAction]>;
 };
 export {};

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/types.d.ts

@@ -1,4 +1,47 @@
+/// <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;
+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;
 export type DateFormatter = (date: Date, format: string) => string;

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;

package/dist/packages/sdk-ui/src/pivot-table/hooks/use-apply-pivot-table-cell-events/get-pivot-table-data-point.d.ts

@@ -0,0 +1,4 @@
+import { type PivotTableDataOptionsInternal } from '../../../chart-data-options/types';
+import { PivotTableDataPoint } from '../../../types';
+import { PivotTableCellPayload } from './types';
+export declare const getPivotTableDataPoint: (cellPayload: PivotTableCellPayload, dataOptions: PivotTableDataOptionsInternal) => PivotTableDataPoint;

package/dist/packages/sdk-ui/src/pivot-table/hooks/use-apply-pivot-table-cell-events/index.d.ts

@@ -0,0 +1 @@
+export { useApplyPivotTableCellEvents } from './use-apply-pivot-table-cell-events';

package/dist/packages/sdk-ui/src/pivot-table/hooks/use-apply-pivot-table-cell-events/types.d.ts

@@ -0,0 +1,32 @@
+type AbstractDataTreeNode = {
+    value: string;
+    content: string;
+    level: number;
+    metadataType: string;
+    userType: string;
+    parent: AbstractDataTreeNode | undefined;
+};
+export type ValueDataNode = AbstractDataTreeNode & {
+    index: number;
+    metadataType: 'measures';
+    userType: 'measureBottom' | 'measureTop';
+};
+export type RowDataNode = AbstractDataTreeNode & {
+    index: number;
+    metadataType: 'rows';
+    userType: 'corner' | 'subTotal' | 'grandTotal';
+};
+export type ColumnDataNode = AbstractDataTreeNode & {
+    index: number;
+    metadataType: 'columns';
+    userType: 'subTotal' | 'grandTotal';
+};
+export type PivotTableCellPayload = {
+    dataNode: ValueDataNode | RowDataNode | ColumnDataNode;
+    rowTreeNode?: RowDataNode;
+    columnTreeNode?: ColumnDataNode;
+    measureTreeNode?: ValueDataNode;
+    isDataCell: boolean;
+    event: MouseEvent;
+};
+export type { AbstractDataTreeNode };

package/dist/packages/sdk-ui/src/pivot-table/hooks/use-apply-pivot-table-cell-events/use-apply-pivot-table-cell-events.d.ts

@@ -0,0 +1,18 @@
+import { type PivotTableDataOptionsInternal } from '../../../chart-data-options/types';
+import { PivotTableDataPointEventHandler } from '../../../index-typedoc';
+import { PivotTableCellPayload } from './types';
+type UseApplyPivotTableCellEventsProps = {
+    dataOptions: PivotTableDataOptionsInternal;
+    onDataPointClick?: PivotTableDataPointEventHandler;
+    onDataPointContextMenu?: PivotTableDataPointEventHandler;
+};
+type UseApplyPivotTableCellEventsResult = {
+    handlePivotTableCellClick: (payload: PivotTableCellPayload) => void;
+};
+/**
+ * A hook that applies pivot table cell events.
+ *
+ * @internal
+ */
+export declare const useApplyPivotTableCellEvents: ({ dataOptions, onDataPointClick, onDataPointContextMenu, }: UseApplyPivotTableCellEventsProps) => UseApplyPivotTableCellEventsResult;
+export {};

package/dist/packages/sdk-ui/src/pivot-table/hooks/use-apply-pivot-table-cell-events/utils.d.ts

@@ -0,0 +1,11 @@
+import { AbstractDataTreeNode } from './types';
+export declare function getTreeNodeByLevel(node: AbstractDataTreeNode, level: number): AbstractDataTreeNode;
+export declare function isSubTotalTreeNode(node: AbstractDataTreeNode, type: 'rows' | 'columns'): boolean;
+export declare function isGrandTotalTreeNode(node: AbstractDataTreeNode, type: 'rows' | 'columns'): boolean;
+/**
+ * Safely performs modulo operation, returning 0 if divisor is null/undefined or 0
+ * @param dividend - The dividend number (defaults to 0 if not provided)
+ * @param divisor - The divisor number (optional)
+ * @returns The result of dividend % divisor, or 0 if divisor is invalid
+ */
+export declare function safeModulo(dividend?: number, divisor?: number): number;

package/dist/packages/sdk-ui/src/pivot-table/hooks/use-apply-pivot-table-formatting.d.ts

@@ -1,11 +1,14 @@
 import { type DataService } from '@sisense/sdk-pivot-client';
-import { type PivotTableDataOptions } from '../../chart-data-options/types';
+import { type PivotTableDataOptionsInternal } from '../../chart-data-options/types';
+import { type CustomDataCellFormatter, type CustomHeaderCellFormatter } from '../../pivot-table/formatters/types';
 /**
  * A hook that applies formatting over pivot table cells.
  *
  * @internal
  */
-export declare const useApplyPivotTableFormatting: ({ dataService, dataOptions, }: {
+export declare const useApplyPivotTableFormatting: ({ dataService, dataOptions, onDataCellFormat, onHeaderCellFormat, }: {
     dataService: DataService;
-    dataOptions: PivotTableDataOptions;
+    dataOptions: PivotTableDataOptionsInternal;
+    onDataCellFormat?: CustomDataCellFormatter | undefined;
+    onHeaderCellFormat?: CustomHeaderCellFormatter | undefined;
 }) => void;

package/dist/packages/sdk-ui/src/pivot-table/hooks/use-render-pivot.d.ts

@@ -1,13 +1,13 @@
-/// <reference types="react" />
 import { type PivotBuilder } from '@sisense/sdk-pivot-client';
 import type { CompleteThemeSettings, PivotTableStyleOptions } from '../../types';
-import type { PivotTableDataOptions } from '../../chart-data-options/types';
+import type { PivotTableDataOptionsInternal } from '../../chart-data-options/types';
 import type { ContainerSize } from '../../dynamic-size-container/dynamic-size-container';
+import { PivotTableDataPointEventHandler } from '../../index-typedoc';
 type PivotRenderOptions = {
     /** The pivot builder instance. */
     pivotBuilder: PivotBuilder;
     /** The pivot table data options. */
-    dataOptions: PivotTableDataOptions;
+    dataOptions: PivotTableDataOptionsInternal;
     /** The pivot table style options. */
     styleOptions: PivotTableStyleOptions;
     /** The theme settings. */
@@ -16,11 +16,15 @@ type PivotRenderOptions = {
     size: ContainerSize | null;
     /** Callback to handle total height change. */
     onTotalHeightChange?: (totalHeight: number) => void;
+    /** Callback to handle data point click. */
+    onDataPointClick?: PivotTableDataPointEventHandler;
+    /** Callback to handle data point context menu. */
+    onDataPointContextMenu?: PivotTableDataPointEventHandler;
 };
 /**
  * A hook that renders the pivot table.
  */
-export declare function useRenderPivot({ pivotBuilder, dataOptions, styleOptions, themeSettings, size, onTotalHeightChange, }: PivotRenderOptions): {
+export declare function useRenderPivot({ pivotBuilder, dataOptions, styleOptions, themeSettings, size, onTotalHeightChange, onDataPointClick, onDataPointContextMenu, }: PivotRenderOptions): {
     pivotElement: JSX.Element | null;
 };
 export {};

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

@@ -1,5 +1,6 @@
 import { Attribute, Filter, Measure, DataSource, Data, QueryResultData, FilterRelations } from '@sisense/sdk-data';
-import { ChartDataOptions, CartesianChartDataOptions, CategoricalChartDataOptions, ThemeSettings, PolarStyleOptions, PieStyleOptions, StackableStyleOptions, LineStyleOptions, AreaStyleOptions, FunnelStyleOptions, ScatterStyleOptions, ChartStyleOptions, ChartType, IndicatorStyleOptions, DrilldownOptions, ThemeOid, TreemapStyleOptions, CustomDrilldownResult, MenuPosition, MenuAlignment, MenuItemSection, SunburstStyleOptions, ChartWidgetStyleOptions, TableWidgetStyleOptions, WidgetByIdStyleOptions, BoxplotStyleOptions, ScattermapStyleOptions, AreamapStyleOptions, DataPoint, ScatterDataPoint, AreamapDataPoint, BoxplotDataPoint, ChartDataPoints, ScattermapDataPoint, PivotTableStyleOptions, PivotTableWidgetStyleOptions, RegularChartType, RegularChartStyleOptions, TabularChartStyleOptions, TableStyleOptions, AreaRangeStyleOptions, DrilldownSelection, TextWidgetStyleOptions, GenericDataOptions, IndicatorRenderOptions, TabberStyleProps, IndicatorDataPoint, TextWidgetDataPoint, CustomWidgetStyleOptions } from './types';
+import { ChartDataOptions, CartesianChartDataOptions, CategoricalChartDataOptions, ThemeSettings, PolarStyleOptions, PieStyleOptions, StackableStyleOptions, LineStyleOptions, AreaStyleOptions, FunnelStyleOptions, ScatterStyleOptions, ChartStyleOptions, ChartType, IndicatorStyleOptions, DrilldownOptions, ThemeOid, TreemapStyleOptions, CustomDrilldownResult, MenuPosition, MenuAlignment, MenuItemSection, SunburstStyleOptions, ChartWidgetStyleOptions, TableWidgetStyleOptions, WidgetByIdStyleOptions, BoxplotStyleOptions, ScattermapStyleOptions, AreamapStyleOptions, DataPoint, ScatterDataPoint, AreamapDataPoint, BoxplotDataPoint, ChartDataPoints, ScattermapDataPoint, PivotTableStyleOptions, PivotTableWidgetStyleOptions, RegularChartType, RegularChartStyleOptions, TabularChartStyleOptions, TableStyleOptions, AreaRangeStyleOptions, DrilldownSelection, TextWidgetStyleOptions, GenericDataOptions, IndicatorRenderOptions, TabberStyleProps, IndicatorDataPoint, TextWidgetDataPoint, CustomWidgetStyleOptions, PivotTableDataPoint } from './types';
+import { type CustomDataCellFormatter, type CustomHeaderCellFormatter } from './pivot-table/formatters/types';
 import { HighchartsOptions } from './chart-options-processor/chart-options-service';
 import { ComponentType, PropsWithChildren, ReactNode } from 'react';
 import { IndicatorChartDataOptions, BoxplotChartCustomDataOptions, BoxplotChartDataOptions, ScatterChartDataOptions, TableDataOptions, ScattermapChartDataOptions, AreamapChartDataOptions, PivotTableDataOptions, RegularChartDataOptions, TabularChartDataOptions, RangeChartDataOptions } from './chart-data-options/types';
@@ -306,6 +307,14 @@ export type TextWidgetDataPointEventHandler = (
 point: TextWidgetDataPoint, 
 /** Native MouseEvent */
 nativeEvent: MouseEvent) => void;
+/**
+ * Click handler for when a pivot table cell is clicked.
+ */
+export type PivotTableDataPointEventHandler = (
+/** Data point that was clicked */
+point: PivotTableDataPoint, 
+/** Native MouseEvent */
+nativeEvent: MouseEvent) => void;
 interface HighchartsBasedChartEventProps {
     /**
      * A callback that allows you to customize the underlying chart element before it is rendered.
@@ -871,6 +880,62 @@ export interface PivotTableProps {
      * @internal
      */
     onHeightChange?: (height: number) => void;
+    /**
+     * Callback function that is called when the pivot table cell is clicked
+     *
+     * @internal
+     */
+    onDataPointClick?: PivotTableDataPointEventHandler;
+    /**
+     * Callback function that is called when the pivot table cell is right-clicked
+     *
+     * @internal
+     */
+    onDataPointContextMenu?: PivotTableDataPointEventHandler;
+    /**
+     * Applies custom styling and behavior to pivot table data cells.
+     *
+     * This formatter function returns formatting objects instead of mutating parameters,
+     * following functional programming principles. Use this single callback to combine
+     * multiple handlers and control the call sequence from outside the pivot.
+     *
+     * @example
+     * ```typescript
+     * const customDataFormatter: CustomDataCellFormatter = (cell, jaqlPanelItem, dataOption, id) => {
+     *   if (cell.value > 1000) {
+     *     return {
+     *       style: { backgroundColor: 'lightgreen' },
+     *       content: `${cell.value} (High)`
+     *     };
+     *   }
+     * };
+     * ```
+     *
+     * @internal
+     */
+    onDataCellFormat?: CustomDataCellFormatter;
+    /**
+     * Applies custom styling and behavior to pivot table row and column headers.
+     *
+     * This formatter function returns formatting objects instead of mutating parameters,
+     * following functional programming principles. Use this single callback to combine
+     * multiple handlers and control the call sequence from outside the pivot.
+     *
+     * @example
+     * ```typescript
+     * const customHeaderFormatter: CustomHeaderCellFormatter = (cell, jaqlPanelItem, dataOption, id) => {
+     *   if (cell.content === 'Total') {
+     *     return {
+     *       style: { fontWeight: 'bold', color: 'blue' },
+     *       className: 'total-header'
+     *     };
+     *   }
+     * };
+     * ```
+     *
+     * @internal
+     */
+    onHeaderCellFormat?: CustomHeaderCellFormatter;
 }
 /**
  * Props of the {@link ScatterChart} component.
@@ -1182,6 +1247,62 @@ export interface PivotTableWidgetProps {
      * @category Widget
      */
     description?: string;
+    /**
+     * Callback function that is called when the pivot table cell is clicked
+     *
+     * @internal
+     */
+    onDataPointClick?: PivotTableDataPointEventHandler;
+    /**
+     * Callback function that is called when the pivot table cell is right-clicked
+     *
+     * @internal
+     */
+    onDataPointContextMenu?: PivotTableDataPointEventHandler;
+    /**
+     * Applies custom styling and behavior to pivot table data cells.
+     *
+     * This formatter function returns formatting objects instead of mutating parameters,
+     * following functional programming principles. Use this single callback to combine
+     * multiple handlers and control the call sequence from outside the pivot.
+     *
+     * @example
+     * ```typescript
+     * const customDataFormatter: CustomDataCellFormatter = (cell, jaqlPanelItem, dataOption, id) => {
+     *   if (cell.value > 1000) {
+     *     return {
+     *       style: { backgroundColor: 'lightgreen' },
+     *       content: `${cell.value} (High)`
+     *     };
+     *   }
+     * };
+     * ```
+     *
+     * @internal
+     */
+    onDataCellFormat?: CustomDataCellFormatter;
+    /**
+     * Applies custom styling and behavior to pivot table row and column headers.
+     *
+     * This formatter function returns formatting objects instead of mutating parameters,
+     * following functional programming principles. Use this single callback to combine
+     * multiple handlers and control the call sequence from outside the pivot.
+     *
+     * @example
+     * ```typescript
+     * const customHeaderFormatter: CustomHeaderCellFormatter = (cell, jaqlPanelItem, dataOption, id) => {
+     *   if (cell.content === 'Total') {
+     *     return {
+     *       style: { fontWeight: 'bold', color: 'blue' },
+     *       className: 'total-header'
+     *     };
+     *   }
+     * };
+     * ```
+     *
+     * @internal
+     */
+    onHeaderCellFormat?: CustomHeaderCellFormatter;
 }
 /**
  * Props for the `TextWidget` component.

package/dist/packages/sdk-ui/src/query/date-formats/apply-date-format.d.ts

@@ -53,13 +53,14 @@ export type DateConfig = {
 };
 export declare const defaultDateConfig: DateConfig;
 /**
- * Returns a formatted date, according to the provided date format string.
+ * Safely formats a date value, handling special cases like 'N\A'
  *
- * @param date -
- * @param format -
- * @param locale -
- * @param cfg -
+ * @param value - The date value to format, can be a Date object, ISO string, or special value like 'N\A'
+ * @param format - The date format to apply
+ * @param locale - Optional locale for formatting
+ * @param cfg - Optional date configuration
+ * @returns Formatted date string or the original value for special cases
  */
-export declare function applyDateFormat(date: Date, format: DateFormat, locale?: Locale, cfg?: DateConfig): string;
+export declare function formatDateValue(value: Date | string, format: DateFormat, locale?: Locale, cfg?: DateConfig): string;
 export declare function getDefaultDateMask(granularity?: string): "HH:mm:ss" | "yyyy" | "MM/yyyy" | "ww yyyy" | "HH:mm" | "Q yyyy" | "shortDate" | "fullDate";
 export {};

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

@@ -1,2 +1,2 @@
 export type { DateFormat, DateConfig } from './apply-date-format';
-export { applyDateFormat, defaultDateConfig } from './apply-date-format';
+export { formatDateValue, defaultDateConfig } from './apply-date-format';

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

@@ -1,5 +1,5 @@
 import { CreateCacheKeyFn } from '../utils/create-cache';
-import { Attribute, Measure, PivotAttribute, PivotMeasure, PivotQueryResultData, QueryResultData } from '@sisense/sdk-data';
+import { Attribute, DataSource, Measure, PivotAttribute, PivotMeasure, PivotQueryResultData, QueryResultData } from '@sisense/sdk-data';
 import type { QueryDescription as InternalQueryDescription, PivotQueryDescription as InternalPivotQueryDescription, QueryExecutionConfig } from '@sisense/sdk-query-client';
 import { ClientApplication } from '../app/client-application';
 /**
@@ -26,6 +26,8 @@ export type PivotQueryDescription = Partial<Omit<InternalPivotQueryDescription,
     values?: (Measure | PivotMeasure)[];
 };
 /** @internal */
+export declare const prepareQueryParams: (queryDescription: QueryDescription, defaultDataSource?: DataSource) => InternalQueryDescription;
+/** @internal */
 export declare function executeQuery(queryDescription: QueryDescription, app: ClientApplication, executionConfig?: QueryExecutionConfig): Promise<QueryResultData>;
 /** @internal */
 export declare const executeCsvQuery: (queryDescription: QueryDescription, app: ClientApplication, executionConfig?: QueryExecutionConfig) => Promise<Blob>;

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

@@ -5,4 +5,4 @@ export { ExecuteQueryByWidgetId } from './execute-query-by-widget-id';
 export { useExecuteQueryByWidgetId, executeQueryByWidgetId, } from './use-execute-query-by-widget-id';
 export { useExecutePivotQuery } from './use-execute-pivot-query';
 export { useQueryCache } from './use-query-cache';
-export type { QueryState, QueryLoadingState, QuerySuccessState, QueryErrorState, CsvQueryState, CsvQueryLoadingState, CsvQuerySuccessState, CsvQueryErrorState, PivotQueryState, PivotQueryLoadingState, PivotQuerySuccessState, PivotQueryErrorState, ExecuteQueryParams, ExecuteQueryResult, ExecuteCsvQueryParams, ExecuteCSVQueryConfig, ExecuteQueryByWidgetIdParams, QueryByWidgetIdState, QueryByWidgetIdQueryParams, ExecutePivotQueryParams, } from './types';
+export type { QueryState, QueryLoadingState, QuerySuccessState, QueryErrorState, CsvQueryState, CsvQueryLoadingState, CsvQuerySuccessState, CsvQueryErrorState, PivotQueryState, PivotQueryLoadingState, PivotQuerySuccessState, PivotQueryErrorState, BaseQueryParams, ExecuteQueryParams, ExecuteQueryResult, ExecuteCsvQueryParams, ExecuteCSVQueryConfig, ExecuteQueryByWidgetIdParams, QueryByWidgetIdState, QueryByWidgetIdQueryParams, ExecutePivotQueryParams, } from './types';

package/dist/packages/sdk-ui/src/query-execution/types.d.ts

@@ -171,9 +171,11 @@ export type QueryByWidgetIdQueryParams = {
  */
 export type QueryByWidgetIdState = QueryState & QueryByWidgetIdQueryParams;
 /**
- * Parameters for {@link useExecuteQuery} hook.
+ * Base query parameters
+ *
+ * @internal
  */
-export interface ExecuteQueryParams {
+export interface BaseQueryParams {
     /**
      * Data source the query is run against - e.g. `Sample ECommerce`
      *
@@ -188,6 +190,11 @@ export interface ExecuteQueryParams {
     filters?: Filter[] | FilterRelations;
     /** Highlight filters that will highlight results that pass filter criteria */
     highlights?: Filter[];
+}
+/**
+ * Parameters for {@link useExecuteQuery} hook.
+ */
+export interface ExecuteQueryParams extends BaseQueryParams {
     /**
      * Number of rows to return in the query result
      *

package/dist/packages/sdk-ui/src/theme-provider/default-theme-settings.d.ts

@@ -3,7 +3,12 @@ export declare const DEFAULT_DIVIDER_COLOR = "#F2F2F2";
 export declare const DEFAULT_DIVIDER_WIDTH = 4;
 export declare const DEFAULT_DASHBOARD_BORDER_COLOR = "#D5D5D5";
 export declare const DEFAULT_DASHBOARD_BORDER_WIDTH = 1;
+export declare const DEFAULT_DASHBOARD_TOOLBAR_DIVIDER_LINE_COLOR = "#D5D5D5";
+export declare const DEFAULT_DASHBOARD_TOOLBAR_DIVIDER_LINE_WIDTH = 1;
+export declare const DEFAULT_FILTER_PANEL_DIVIDER_LINE_COLOR = "#DADADA";
+export declare const DEFAULT_FILTER_PANEL_DIVIDER_LINE_WIDTH = 1;
 export declare const DEFAULT_FILTER_PANEL_BORDER_COLOR = "#DADADA";
+export declare const DEFAULT_FILTER_PANEL_BORDER_WIDTH = 1;
 export declare const DEFAULT_TITLE_FONT_SIZE = 15;
 /**
  * Returns default theme settings, which can be used as base for custom theme options.