@sisense/sdk-ui 2.17.0 → 2.18.0

package/dist/packages/sdk-ui/src/analytics-composer/nlq-v3-translator/common.d.ts

@@ -1,5 +1,27 @@
 import { Attribute, DateDimension, JaqlDataSourceForDto } from '@sisense/sdk-data';
-import { NlqTranslationResult, NormalizedTable } from '../types.js';
+import { NlqTranslationResult, NormalizedColumn, NormalizedTable } from '../types.js';
+/**
+ * Schema index for efficient table/column lookups and greedy matching
+ * @internal
+ */
+export interface SchemaIndex {
+    /** Tables sorted by name length (descending) for greedy matching */
+    sortedTables: NormalizedTable[];
+    /** Columns sorted by name length (descending) per table for greedy matching */
+    tableColumnMap: Map<string, NormalizedColumn[]>;
+    /** O(1) table lookup by exact name */
+    tableMap: Map<string, NormalizedTable>;
+    /** O(1) column lookup: table name → (column name → column) */
+    columnMap: Map<string, Map<string, NormalizedColumn>>;
+}
+/**
+ * Creates a schema index with pre-sorted arrays and Maps for efficient lookups
+ *
+ * @param tables - Array of normalized tables
+ * @returns SchemaIndex with sorted arrays and Maps
+ * @internal
+ */
+export declare function createSchemaIndex(tables: NormalizedTable[]): SchemaIndex;
 /**
  * Validates that an attribute is compatible with text values
  *
@@ -44,7 +66,7 @@ export declare function isNonDateLevelAttribute(attribute: Attribute): boolean;
  * @returns A human-readable string representing the attribute type
  */
 export declare function getAttributeTypeDisplayString(attribute: Attribute): string;
-export declare function createAttributeFromName(attributeName: string, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]): Attribute | import("@sisense/sdk-data").LevelAttribute;
-export declare function createDateDimensionFromName(dateDimensionName: string, dataSource: JaqlDataSourceForDto, tables: NormalizedTable[]): DateDimension;
+export declare function createAttributeFromName(attributeName: string, dataSource: JaqlDataSourceForDto, schemaIndex: SchemaIndex): Attribute | import("@sisense/sdk-data").LevelAttribute;
+export declare function createDateDimensionFromName(dateDimensionName: string, dataSource: JaqlDataSourceForDto, schemaIndex: SchemaIndex): DateDimension;
 export declare function getSuccessData<T>(result: NlqTranslationResult<T>): T;
 export declare function getErrors<T>(result: NlqTranslationResult<T>): string[];

package/dist/packages/sdk-ui/src/analytics-composer/nlq-v3-translator/types.d.ts

@@ -1,5 +1,16 @@
-import { Filter, FilterRelations, JSONArray, JSONValue, Measure } from '@sisense/sdk-data';
-import { DataSchemaContext, NlqTranslationInput } from '../types';
+import { Filter, FilterRelations, JaqlDataSourceForDto, JSONArray, JSONValue, Measure } from '@sisense/sdk-data';
+import { NlqTranslationInput } from '../types.js';
+import type { SchemaIndex } from './common.js';
+/**
+ * Internal context type that uses schemaIndex for efficient lookups
+ * @internal
+ */
+export interface InternalDataSchemaContext {
+    /** The data source being used for the query */
+    dataSource: JaqlDataSourceForDto;
+    /** Schema index for efficient table/column lookups */
+    schemaIndex: SchemaIndex;
+}
 export declare const DIMENSIONAL_NAME_PREFIX = "DM.";
 export type ArgType = 'string' | 'string[]' | 'number' | 'number[]' | 'boolean' | 'Attribute' | 'Attribute[]' | 'Measure' | 'BaseMeasure' | 'Measure[]' | 'Filter' | 'Filter[]' | 'FilterRelationsNode' | 'DateDimension' | 'LevelAttribute' | 'Measure | number' | 'Date | string' | 'string | number' | 'BaseFilterConfig' | 'MembersFilterConfig' | 'CustomFormulaContext' | 'any';
 export interface ArgSchema {
@@ -17,21 +28,22 @@ export type FunctionCall = {
 /**
  * Context object passed to all custom processors containing runtime information
  * needed for processing.
+ * @internal
  */
-export interface FunctionContext extends DataSchemaContext {
+export interface FunctionContext extends InternalDataSchemaContext {
     /** Path prefix for error messages (e.g., 'args[0].function') */
     pathPrefix: string;
 }
 export interface ArgContext extends FunctionContext {
     argSchema: ArgSchema;
 }
-export type DimensionsInput = NlqTranslationInput<JSONArray, DataSchemaContext>;
-export type MeasuresInput = NlqTranslationInput<JSONArray, DataSchemaContext>;
-export type FiltersInput = NlqTranslationInput<JSONArray, DataSchemaContext>;
-export type HighlightsInput = NlqTranslationInput<JSONArray, DataSchemaContext>;
-export type MeasuresFunctionCallInput = NlqTranslationInput<FunctionCall[], DataSchemaContext>;
-export type FiltersFunctionCallInput = NlqTranslationInput<FunctionCall[], DataSchemaContext>;
-export type HighlightsFunctionCallInput = NlqTranslationInput<FunctionCall[], DataSchemaContext>;
+export type DimensionsInput = NlqTranslationInput<JSONArray, InternalDataSchemaContext>;
+export type MeasuresInput = NlqTranslationInput<JSONArray, InternalDataSchemaContext>;
+export type FiltersInput = NlqTranslationInput<JSONArray, InternalDataSchemaContext>;
+export type HighlightsInput = NlqTranslationInput<JSONArray, InternalDataSchemaContext>;
+export type MeasuresFunctionCallInput = NlqTranslationInput<FunctionCall[], InternalDataSchemaContext>;
+export type FiltersFunctionCallInput = NlqTranslationInput<FunctionCall[], InternalDataSchemaContext>;
+export type HighlightsFunctionCallInput = NlqTranslationInput<FunctionCall[], InternalDataSchemaContext>;
 export type NodeInput = NlqTranslationInput<FunctionCall, FunctionContext>;
 export type ArgInput = NlqTranslationInput<Arg, ArgContext>;
 /**

package/dist/packages/sdk-ui/src/chart-options-processor/data-points.d.ts

@@ -1,11 +1,12 @@
 import { Measure } from '@sisense/sdk-data';
 import { ChartDataOptionsInternal } from '../chart-data-options/types';
 import { SisenseChartDataPoint } from '../sisense-chart/types';
-import { HighchartsPoint, StyledColumn, StyledMeasureColumn } from '../types';
+import { DataOptionLocation, HighchartsPoint, StyledColumn, StyledMeasureColumn } from '../types';
 export declare function createFormatter(dataOption: StyledColumn | StyledMeasureColumn): (value?: number | string | Date) => string;
-export declare function getDataPointMetadata(dataOption: StyledColumn | StyledMeasureColumn): {
+export declare function getDataPointMetadata(dataOption: StyledColumn | StyledMeasureColumn, dataOptionLocation?: DataOptionLocation): {
     measure?: Measure | undefined;
     attribute?: import("@sisense/sdk-data").Attribute | undefined;
+    dataOptionLocation?: DataOptionLocation | undefined;
     dataOption: StyledColumn | StyledMeasureColumn;
 };
 export declare function getDataPoint(point: HighchartsPoint, dataOptions: ChartDataOptionsInternal): SisenseChartDataPoint;

package/dist/packages/sdk-ui/src/common-filters/utils.d.ts

@@ -1,6 +1,25 @@
 import { Attribute, Filter } from '@sisense/sdk-data';
+import { ChartDataOptions, ChartType, DrilldownOptions, GenericDataOptions, PivotTableDataOptions, PivotTableDrilldownOptions, WidgetType } from '../index.js';
 import { FiltersIgnoringRules, PureFilter } from './types.js';
 export declare function getAllowedFilters(filters: PureFilter[], ignoreFiltersOptions: FiltersIgnoringRules): Filter[];
 export declare function getFilterByAttribute(filters: Filter[], attribute: Attribute): Filter | undefined;
 export declare function createCommonFilter(attribute: Attribute, members: (string | number)[], existingCommonFilters: Filter[]): Filter;
 export declare function isEqualMembersFilters(filterA: Filter, filterB: Filter): boolean;
+type GetWidgetDataOptionsWithDrilldownParams = {
+    widgetType?: WidgetType;
+    chartType?: ChartType;
+    dataOptions: ChartDataOptions | PivotTableDataOptions | GenericDataOptions;
+    drilldownOptions?: DrilldownOptions | PivotTableDrilldownOptions;
+};
+/**
+ * Applies drilldown to the widget data options.
+ *
+ * @param params - The parameters for the function.
+ * @param params.widgetType - The type of the widget.
+ * @param params.chartType - The type of the chart.
+ * @param params.dataOptions - The data options of the widget.
+ * @param params.drilldownOptions - The drilldown options of the widget.
+ * @returns The widget data options with drilldown applied.
+ */
+export declare function getWidgetDataOptionsWithDrilldown({ widgetType, chartType, dataOptions, drilldownOptions, }: GetWidgetDataOptionsWithDrilldownParams): import('../index.js').CategoricalChartDataOptions | import('../index.js').ScatterChartDataOptions | import('../index.js').IndicatorChartDataOptions | import('../index.js').BoxplotChartDataOptions | import('../index.js').BoxplotChartCustomDataOptions | import('../index.js').AreamapChartDataOptions | import('../index.js').ScattermapChartDataOptions | import('../index.js').RangeChartDataOptions | import('../index.js').CalendarHeatmapChartDataOptions | import('../index.js').TableDataOptions | PivotTableDataOptions | GenericDataOptions;
+export {};

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

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+import { WidgetsPanelRow } from '../../../../models';
+import { WidgetProps } from '../../../../props';
+export interface EditableLayoutRowProps {
+    children: (isAutoHeight: boolean) => ReactNode;
+    id: string;
+    row: WidgetsPanelRow;
+    widgets: WidgetProps[];
+    onHeightChange: (height: number) => void;
+}
+export declare const EditableLayoutRow: ({ children, id, row, widgets, onHeightChange, }: EditableLayoutRowProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -4,4 +4,16 @@ export { type JumpToDashboardConfig, type JumpToDashboardConfigForPivot, type Jt
  * @internal
  */
 export { useJtdInternal } from './use-jtd';
+/**
+ * Internal function to apply JTD functionality to widget props
+ * Used by framework adapters (Vue, Angular)
+ * @internal
+ */
+export { applyJtdToWidget } from './use-jtd';
+/**
+ * Internal function to normalize JTD config
+ * Used by framework adapters (Vue, Angular)
+ * @internal
+ */
+export { normalizeToJtdConfig } from './jtd/jtd-config-transformers';
 export { useJtdWidget } from './use-jtd-widget';

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

@@ -10,3 +10,18 @@ export declare const getDividerStyle: (color: string, width: number) => string;
  * @returns The default layout for the widgets.
  */
 export declare const getDefaultWidgetsPanelLayout: (widgets: WidgetProps[]) => WidgetsPanelColumnLayout;
+/**
+ * With optionally disabled auto height.
+ *
+ * @param widgetProps - The widget props to disable the auto height for.
+ * @param shouldDisable - Whether to disable the auto height.
+ * @returns The widget props with the auto height disabled if applicable.
+ */
+export declare const withOptionallyDisabledAutoHeight: (widgetProps: WidgetProps, shouldDisable: boolean) => WidgetProps;
+/**
+ * Checks if all widgets have auto height and supports dynamic height.
+ *
+ * @param widgetProps - The widget props to check for auto height.
+ * @returns True if all widgets have auto height, false otherwise.
+ */
+export declare const checkForAutoHeight: (widgetProps: WidgetProps[]) => boolean;

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

@@ -1,3 +1,2 @@
 export { MemberFilterTile, type MemberFilterTileProps } from './member-filter-tile';
-export { BasicMemberFilterTile, type BasicMemberFilterTileProps } from './basic-member-filter-tile';
 export type { Member, SelectedMember } from './members-reducer';

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

@@ -1,7 +1,9 @@
 import { FunctionComponent } from 'react';
+import { ScrollWrapperOnScrollEvent } from '../filter-editor-popover/common/scroll-wrapper';
 import { Member, SelectedMember } from './members-reducer';
 export interface MemberListProps {
     members: Member[];
+    isMembersLoading?: boolean;
     selectedMembers: SelectedMember[];
     onSelectMember: (member: Member, isSelected: boolean) => void;
     checkAllMembers: () => void;
@@ -9,5 +11,8 @@ export interface MemberListProps {
     excludeMembers: boolean;
     enableMultiSelection: boolean;
     disabled: boolean;
+    onListScroll?: (event: ScrollWrapperOnScrollEvent) => void;
+    searchValue?: string;
+    onSearchValueChange?: (searchString: string) => void;
 }
 export declare const MemberList: FunctionComponent<MemberListProps>;

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

@@ -1,7 +1,6 @@
 import type { FunctionComponent } from 'react';
-import { Member, SelectedMember } from './members-reducer';
+import { SelectedMember } from './members-reducer';
 export interface PillSectionProps {
-    members: Member[];
     selectedMembers: SelectedMember[];
     onToggleSelectedMember: (key: string) => void;
     excludeMembers: boolean;

package/dist/packages/sdk-ui/src/filters/hooks/use-get-filter-members.d.ts

@@ -113,6 +113,12 @@ export type GetFilterMembersResult = FilterMembersState & {
      * @internal
      */
     loadMore: (count: number) => void;
+    /**
+     * Flag indicating whether all items have been loaded
+     *
+     * @internal
+     */
+    isAllItemsLoaded: boolean;
 };
 /**
  * {@link useGetFilterMembers} without tracking to be used inside other hooks or components in Compose SDK.

package/dist/packages/sdk-ui/src/models/widget/widget-model.d.ts

@@ -2,7 +2,7 @@ import { DataSource, Filter } from '@sisense/sdk-data';
 import { EmptyObject } from '@sisense/sdk-query-client/src/helpers/utility-types';
 import { ChartDataOptions, PivotTableDataOptions } from '../../chart-data-options/types';
 import type { WidgetType } from '../../props';
-import { ChartType, DrilldownOptions, WidgetStyleOptions } from '../../types';
+import { ChartType, DrilldownOptions, PivotTableDrilldownOptions, WidgetStyleOptions } from '../../types';
 /**
  * Widget data options.
  */
@@ -69,6 +69,6 @@ export interface WidgetModel {
     /**
      * Widget drilldown options.
      */
-    drilldownOptions: DrilldownOptions;
+    drilldownOptions: DrilldownOptions | PivotTableDrilldownOptions;
 }
 export declare const isWidgetModel: (widget: any) => widget is WidgetModel;

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

@@ -9,7 +9,7 @@ import { Hierarchy } from './models';
 import { type CustomDataCellFormatter, type CustomHeaderCellFormatter } from './pivot-table/formatters/types';
 import { ExecuteQueryParams, QueryByWidgetIdState } from './query-execution';
 import { ExecuteQueryResult } from './query-execution/types';
-import { AreamapDataPoint, AreamapStyleOptions, AreaRangeStyleOptions, AreaStyleOptions, BoxplotDataPoint, BoxplotStyleOptions, CalendarHeatmapDataPoint, CalendarHeatmapStyleOptions, CartesianChartDataOptions, CategoricalChartDataOptions, ChartDataOptions, ChartDataPoints, ChartStyleOptions, ChartType, ChartWidgetStyleOptions, CustomDrilldownResult, CustomWidgetStyleOptions, DataPoint, DrilldownOptions, DrilldownSelection, FunnelStyleOptions, GenericDataOptions, IndicatorDataPoint, IndicatorRenderOptions, IndicatorStyleOptions, LineStyleOptions, MenuAlignment, MenuItemSection, MenuPosition, PieStyleOptions, PivotTableDataPoint, PivotTableStyleOptions, PivotTableWidgetStyleOptions, PolarStyleOptions, RegularChartStyleOptions, RegularChartType, ScatterDataPoint, ScattermapDataPoint, ScattermapStyleOptions, ScatterStyleOptions, StackableStyleOptions, StreamgraphStyleOptions, SunburstStyleOptions, TableStyleOptions, TableWidgetStyleOptions, TabularChartStyleOptions, TextWidgetDataPoint, TextWidgetStyleOptions, ThemeConfig, ThemeOid, ThemeSettings, TreemapStyleOptions, WidgetByIdStyleOptions } from './types';
+import { AreamapDataPoint, AreamapStyleOptions, AreaRangeStyleOptions, AreaStyleOptions, BoxplotDataPoint, BoxplotStyleOptions, CalendarHeatmapDataPoint, CalendarHeatmapStyleOptions, CartesianChartDataOptions, CategoricalChartDataOptions, ChartDataOptions, ChartDataPoints, ChartStyleOptions, ChartType, ChartWidgetStyleOptions, CustomDrilldownResult, CustomWidgetStyleOptions, DataPoint, DrilldownOptions, DrilldownSelection, FunnelStyleOptions, GenericDataOptions, IndicatorDataPoint, IndicatorRenderOptions, IndicatorStyleOptions, LineStyleOptions, MenuAlignment, MenuItemSection, MenuPosition, PieStyleOptions, PivotTableDataPoint, PivotTableDrilldownOptions, PivotTableStyleOptions, PivotTableWidgetStyleOptions, PolarStyleOptions, RegularChartStyleOptions, RegularChartType, ScatterDataPoint, ScattermapDataPoint, ScattermapStyleOptions, ScatterStyleOptions, StackableStyleOptions, StreamgraphStyleOptions, SunburstStyleOptions, TableStyleOptions, TableWidgetStyleOptions, TabularChartStyleOptions, TextWidgetDataPoint, TextWidgetStyleOptions, ThemeConfig, ThemeOid, ThemeSettings, TreemapStyleOptions, WidgetByIdStyleOptions } from './types';
 import { DistributiveOmit } from './utils/utility-types/distributive-omit';
 import { FiltersMergeStrategy } from './widget-by-id/types';
 export type { TabberButtonsWidgetProps } from './widgets/tabber/types';
@@ -968,13 +968,13 @@ export interface PivotTableProps {
     /**
      * Callback function that is called when the pivot table cell is clicked
      *
-     * @internal
+     * @category Callbacks
      */
     onDataPointClick?: PivotTableDataPointEventHandler;
     /**
      * Callback function that is called when the pivot table cell is right-clicked
      *
-     * @internal
+     * @category Callbacks
      */
     onDataPointContextMenu?: PivotTableDataPointEventHandler;
     /**
@@ -1042,7 +1042,7 @@ export interface ScatterChartProps extends BaseChartProps, ScatterChartEventProp
 /**
  * Props for the {@link WidgetById} component
  */
-export interface WidgetByIdProps extends Omit<ChartWidgetProps, 'dataSource' | 'dataOptions' | 'chartType' | 'styleOptions'> {
+export interface WidgetByIdProps extends Omit<ChartWidgetProps, 'dataSource' | 'dataOptions' | 'chartType' | 'styleOptions' | 'drilldownOptions'> {
     /**
      * Identifier of the widget
      *
@@ -1109,7 +1109,7 @@ export interface WidgetByIdProps extends Omit<ChartWidgetProps, 'dataSource' | '
      * @category Widget
      * @internal
      */
-    drilldownOptions?: DrilldownOptions;
+    drilldownOptions?: DrilldownOptions | PivotTableDrilldownOptions;
 }
 /**
  * Props for the {@link ChartWidget} component
@@ -1332,16 +1332,22 @@ export interface PivotTableWidgetProps {
      * @category Widget
      */
     description?: string;
+    /**
+     * Configuration for the pivot table drilldown
+     *
+     * @category Widget
+     */
+    drilldownOptions?: PivotTableDrilldownOptions;
     /**
      * Callback function that is called when the pivot table cell is clicked
      *
-     * @internal
+     * @category Callbacks
      */
     onDataPointClick?: PivotTableDataPointEventHandler;
     /**
      * Callback function that is called when the pivot table cell is right-clicked
      *
-     * @internal
+     * @category Callbacks
      */
     onDataPointContextMenu?: PivotTableDataPointEventHandler;
     /**
@@ -1388,6 +1394,8 @@ export interface PivotTableWidgetProps {
      * @internal
      */
     onHeaderCellFormat?: CustomHeaderCellFormatter;
+    /** @internal */
+    onChange?: (props: Partial<PivotTableWidgetProps>) => void;
 }
 /**
  * Props for the `TextWidget` component.

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

@@ -24,6 +24,7 @@ export declare function newDateFormatWithExpandedYearsMasks(oldFormat: DateForma
  * Takes into consideration:
  * - the configured start month of the customer's fiscal year
  * - the currently selected date level for this particular column of data
+ * - avoid timezone shifts
  *
  * @param oldFormat
  * @param date

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

@@ -246,6 +246,12 @@ export type ExecuteQueryResult = QueryState & {
      * @internal
      */
     loadMore: (count: number) => void;
+    /**
+     * Flag indicating whether all items have been loaded
+     *
+     * @internal
+     */
+    isAllItemsLoaded: boolean;
 };
 /** Configuration for {@link useExecuteCsvQuery} hook. */
 export type ExecuteCSVQueryConfig = {

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

@@ -2139,6 +2139,32 @@ export type DrilldownOptions = {
     /** Current selections for multiple drilldowns */
     drilldownSelections?: DrilldownSelection[];
 };
+/** Configuration for the pivot table drilldown */
+export type PivotTableDrilldownOptions = PivotTableSelectableDrilldownOptions | PivotTableNonSelectableDrilldownOptions;
+/** Configuration for the pivot table drilldown with initial target and selections defined */
+export type PivotTableSelectableDrilldownOptions = {
+    /** Dimensions and hierarchies available for drilldown on */
+    drilldownPaths?: (Attribute | Hierarchy | HierarchyId)[];
+    /** Current selections for multiple drilldowns */
+    drilldownSelections: DrilldownSelection[];
+    /**
+     * Current pivot table data option target for the drilldown
+     *
+     * Can be either:
+     * - An `Attribute` directly (when you know the specific attribute to target)
+     * - A `DataOptionLocation` (when you need to reference a data option by its position in the data options structure)
+     */
+    drilldownTarget: Attribute | DataOptionLocation;
+};
+/** Configuration for the pivot table drilldown without initial target and selections */
+export type PivotTableNonSelectableDrilldownOptions = {
+    /** Dimensions and hierarchies available for drilldown on */
+    drilldownPaths?: (Attribute | Hierarchy | HierarchyId)[];
+    /** Current selections for multiple drilldowns */
+    drilldownSelections?: never;
+    /** Current pivot table data option target for the drilldown */
+    drilldownTarget?: never;
+};
 /** Selection for the drilldown */
 export type DrilldownSelection = {
     /** Points selected for drilldown */
@@ -2146,6 +2172,35 @@ export type DrilldownSelection = {
     /** Dimension to drilldown to */
     nextDimension: Attribute;
 };
+/**
+ * Location within component data options that identifies a specific data option.
+ *
+ * @example
+ * ```typescript
+ * { dataOptionName: 'category', dataOptionIndex: 0 } // First category
+ * { dataOptionName: 'value', dataOptionIndex: 1 }    // Second value measure
+ * ```
+ */
+export type DataOptionLocation = {
+    /**
+     * Data option location name that identifies the property containing the data option.
+     *
+     * Examples:
+     * - PivotTable: `'rows'` | `'columns'` | `'values'`
+     * - Cartesian charts: `'category'` | `'value'` | `'breakBy'`
+     * - Scatter charts: `'x'` | `'y'` | `'breakByPoint'` | `'breakByColor'` | `'size'`
+     */
+    dataOptionName: 'rows' | 'columns' | 'values' | 'category' | 'value' | 'breakBy' | 'x' | 'y' | 'breakByPoint' | 'breakByColor' | 'size' | 'date' | 'geo' | 'color' | 'colorBy' | 'details' | 'outliers' | 'secondary' | 'min' | 'max';
+    /**
+     * Data option location zero-based index.
+     *
+     * Required for array-based locations (e.g., `rows`, `columns`, `values`, `category`).
+     * Optional for single-value locations (e.g., `x`, `y`, `date`).
+     *
+     * @default 0
+     */
+    dataOptionIndex?: number;
+};
 /**
  * Data points in a chart. Array of data points of the same data point type.
  */
@@ -2194,12 +2249,17 @@ export type DataPoint = {
 export type DataPointEntry = {
     /** The data option associated with this entry */
     dataOption: Column | StyledColumn | MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
+    /**
+     * The location of the data option in the data options structure
+     * @internal
+     */
+    dataOptionLocation?: DataOptionLocation;
     /** The attribute associated with this data point entry */
     attribute?: Attribute;
     /** The measure associated with this data point entry */
     measure?: Measure;
     /** The raw value of the data point */
-    value?: string | number;
+    value: string | number;
     /** The formatted value of the data point */
     displayValue?: string;
 };
@@ -2304,20 +2364,14 @@ export type TextWidgetDataPoint = {
 export type PivotTableDataPoint = {
     /**
      * Boolean flag that defines if the data point is a data cell
-     *
-     * @internal
      */
     isDataCell: boolean;
     /**
      * Boolean flag that defines if the data point is a caption cell
-     *
-     * @internal
      */
     isCaptionCell: boolean;
     /**
      * Boolean flag that defines if the data point is a total cell (subtotal or grandtotal)
-     *
-     * @internal
      */
     isTotalCell: boolean;
     /**
@@ -2439,7 +2493,7 @@ export type HighchartsPoint = {
         maskedBreakByPoint?: string;
         maskedBreakByColor?: string;
         maskedSize?: string;
-        rawValue?: string | number;
+        rawValue: string | number;
         xValue?: (string | number)[];
         xDisplayValue?: string[];
         rawValues?: (string | number)[];

package/dist/packages/sdk-ui/src/utils/data-option-location/get-data-option-by-location.d.ts

@@ -0,0 +1,43 @@
+import type { AnyColumn, ChartDataOptions, PivotTableDataOptions } from '../../chart-data-options/types';
+import type { DataOptionLocation } from '../../types';
+/**
+ * Retrieves a data option from the dataOptions structure at the specified location.
+ *
+ * This function is the inverse of {@link getDataOptionLocation} - it takes a location
+ * and returns the data option at that location.
+ *
+ * The function handles both array-based locations (e.g., `category`, `rows`, `values`)
+ * and single-value locations (e.g., `x`, `y`, `date`). For array-based locations,
+ * the `dataOptionIndex` specifies which item to retrieve (defaults to 0 if not provided).
+ *
+ * @param dataOptions - The data options structure to search within (e.g., from various chart types or pivot table)
+ * @param location - The location of the data option to retrieve
+ * @returns The data option at the specified location, or `undefined` if the location doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const dataOptions = {
+ *   category: [DM.Commerce.Date, DM.Category.Category],
+ *   value: [DM.Commerce.Revenue],
+ *   breakBy: [],
+ * };
+ *
+ * // Get first category
+ * const firstCategory = getDataOptionByLocation(dataOptions, {
+ *   dataOptionName: 'category',
+ *   dataOptionIndex: 0,
+ * });
+ * // Result: DM.Commerce.Date
+ *
+ * // Get single value (index defaults to 0)
+ * const scatterDataOptions = {
+ *   x: DM.Commerce.Date,
+ *   y: DM.Commerce.Revenue,
+ * };
+ * const xValue = getDataOptionByLocation(scatterDataOptions, {
+ *   dataOptionName: 'x',
+ * });
+ * // Result: DM.Commerce.Date
+ * ```
+ */
+export declare function getDataOptionByLocation<T = AnyColumn>(dataOptions: ChartDataOptions | PivotTableDataOptions, location: DataOptionLocation): T | undefined;

package/dist/packages/sdk-ui/src/utils/data-option-location/get-data-option-location.d.ts

@@ -0,0 +1,46 @@
+import { Column } from '@sisense/sdk-data';
+import type { ChartDataOptions, PivotTableDataOptions, StyledColumn } from '../../chart-data-options/types';
+import type { DataOptionLocation } from '../../types';
+/**
+ * Finds the location of a data option within abstract dataOptions structure.
+ *
+ * This utility searches through various chart data option structures (e.g., `PivotTableDataOptions`,
+ * `ScattermapChartDataOptions`, `CartesianChartDataOptions`) to locate a specific `Column` (or `StyledColumn`).
+ *
+ * The function uses a generic approach that inspects properties of the `dataOptions` object:
+ * - If a property is an array, each item is treated as a potential data option
+ * - If a property is an object, it is treated as a potential data option
+ *
+ * Data options can be:
+ * - Plain `Column` (attribute)
+ * - `StyledColumn` (attribute with nested `column` property)
+ *
+ * **Limitations:**
+ * - It will **not** find `MeasureColumn`, `CalculatedMeasureColumn`, or `StyledMeasureColumn`. Attempting to search for measures will return `undefined`
+ *
+ * @param dataOptions - The data options structure to search within (e.g., from various chart types or pivot table)
+ * @param targetColumn - The target `Column` (attribute) or `StyledColumn` to find
+ * @returns The location of the data option if found, otherwise `undefined`
+ *
+ * @example
+ * ```typescript
+ * const dataOptions = {
+ *   category: [DM.Commerce.Date],
+ *   value: [DM.Commerce.Revenue],
+ *   breakBy: [],
+ * };
+ * const location = getDataOptionLocation(dataOptions, DM.Commerce.Date);
+ * // Result: { dataOptionName: 'category', dataOptionIndex: 0 }
+ * ```
+ */
+export declare function getDataOptionLocation(dataOptions: ChartDataOptions | PivotTableDataOptions, targetColumn: Column | StyledColumn): DataOptionLocation | undefined;
+/**
+ * Compares two columns to determine if they represent the same attribute.
+ *
+ * This function handles both plain `Column` and `StyledColumn` arguments variants.
+ *
+ * @param columnA - The first column to compare (can be `Column` or `StyledColumn`)
+ * @param columnB - The second column to compare (can be `Column` or `StyledColumn`)
+ * @returns `true` if both columns represent the same attribute, `false` otherwise
+ */
+export declare function isSameColumn(columnA: Column | StyledColumn, columnB: Column | StyledColumn): boolean;

package/dist/packages/sdk-ui/src/utils/data-option-location/index.d.ts

@@ -0,0 +1,3 @@
+export { getDataOptionLocation, isSameColumn } from './get-data-option-location';
+export { getDataOptionByLocation } from './get-data-option-by-location';
+export { setDataOptionAtLocation } from './set-data-option-at-location';

package/dist/packages/sdk-ui/src/utils/data-option-location/set-data-option-at-location.d.ts

@@ -0,0 +1,39 @@
+import type { AnyColumn, ChartDataOptions, PivotTableDataOptions } from '../../chart-data-options/types';
+import type { DataOptionLocation } from '../../types';
+/**
+ * Sets a data option in the dataOptions structure at the specified location.
+ *
+ * This function creates a new dataOptions object with the value updated at the specified location,
+ * following immutable patterns. The original dataOptions object is not modified.
+ *
+ * The function handles both array-based locations (e.g., `category`, `rows`, `values`)
+ * and single-value locations (e.g., `x`, `y`, `date`). For array-based locations,
+ * the `dataOptionIndex` specifies which item to update (defaults to 0 if not provided).
+ *
+ * @param value - The new value to set at the specified location
+ * @param location - The location where to set the data option
+ * @param dataOptions - The data options structure to update (e.g., from various chart types or pivot table)
+ * @returns A new dataOptions object with the updated value, or the original object if the location is invalid
+ *
+ * @example
+ * ```typescript
+ * const dataOptions = {
+ *   category: [DM.Commerce.Date.Years, DM.Category.Category],
+ *   value: [DM.Commerce.Revenue],
+ *   breakBy: [],
+ * };
+ *
+ * // Set first category
+ * const updatedDataOptions = setDataOptionAtLocation(DM.Commerce.Date.Months, { dataOptionName: 'category', dataOptionIndex: 0 }, dataOptions);
+ * // Result: { category: [DM.Commerce.Date.Months, DM.Category.Category], ... }
+ *
+ * // Set single value (index defaults to 0)
+ * const scatterDataOptions = {
+ *   x: DM.Category.Category,
+ *   y: DM.Commerce.Revenue,
+ * };
+ * const updatedScatterDataOptions = setDataOptionAtLocation(DM.Commerce.Cost, { dataOptionName: 'y' }, scatterDataOptions);
+ * // Result: { x: DM.Category.Category, y: DM.Commerce.Cost }
+ * ```
+ */
+export declare function setDataOptionAtLocation<T extends ChartDataOptions | PivotTableDataOptions>(value: AnyColumn, location: DataOptionLocation, dataOptions: T): T;

package/dist/packages/sdk-ui/src/widget-by-id/translate-widget-drilldown-options.d.ts

@@ -1,3 +1,3 @@
-import { DrilldownOptions } from '../types.js';
+import { DrilldownOptions, PivotTableDrilldownOptions } from '../types.js';
 import { FusionWidgetType, Panel, PanelItem } from './types.js';
-export declare const extractDrilldownOptions: (widgetType: FusionWidgetType, panels: Panel[], drillHistory?: PanelItem[], enableDrillToAnywhere?: boolean) => DrilldownOptions;
+export declare const extractDrilldownOptions: (widgetType: FusionWidgetType, panels: Panel[], drillHistory?: PanelItem[], enableDrillToAnywhere?: boolean) => DrilldownOptions | PivotTableDrilldownOptions;

package/dist/packages/sdk-ui/src/widget-by-id/translate-widget-style-options/tabber.d.ts

@@ -1,5 +1,5 @@
 import { TabberButtonsWidgetStyleOptions } from '../../types.js';
-import { TabberWidgetDtoStyle } from '../types.js';
+import { TabberWidgetDto, TabberWidgetDtoStyle } from '../types.js';
 /**
  * Extracts style options from TabberWidgetDtoStyle.
  * Pure function that transforms tabber widget DTO style to CSDK style options.
@@ -14,10 +14,10 @@ export declare function extractTabberButtonsWidgetStyleOptions(tabberStyleDto: T
  * Extracts custom options from TabberWidgetDtoStyle.
  * Pure function that extracts tab names and active tab index from DTO style.
  *
- * @param tabberStyleDto - The tabber widget style from DTO
+ * @param tabberDto - The tabber widget props DTO
  * @returns Object containing tab names and active tab index
  */
-export declare function extractTabberButtonsWidgetCustomOptions(tabberStyleDto: TabberWidgetDtoStyle): {
+export declare function extractTabberButtonsWidgetCustomOptions(tabberDto: TabberWidgetDto): {
     tabNames: string[];
     activeTab: number;
 };