@sisense/sdk-ui 2.28.0 → 2.29.0

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/get-dashboard-model.d.ts

@@ -30,6 +30,13 @@ export interface GetDashboardModelOptions {
      * @internal
      */
     useLegacyApiVersion?: boolean;
+    /**
+     * Whether to fetch the dashboard with admin-level access.
+     *
+     * @default false
+     * @sisenseInternal
+     */
+    adminAccess?: boolean;
 }
 /**
  * Retrieves a dashboard model by its OID.

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/translate-dashboard-utils.d.ts

@@ -1,4 +1,4 @@
-import { Dimension, Filter, FilterRelations, FilterRelationsModel, FilterRelationsModelNode, Measure } from '@sisense/sdk-data';
+import { Dimension, Filter, FilterRelations, Measure } from '@sisense/sdk-data';
 import { JtdTarget, JumpToDashboardConfig, JumpToDashboardConfigForPivot, TriggerMethod } from '../../../domains/dashboarding/hooks/jtd/jtd-types';
 import { TabbersConfig } from '../../../domains/dashboarding/hooks/use-tabber';
 import { Panel, WidgetDto } from '../../../domains/widgets/components/widget-by-id/types';
@@ -7,7 +7,7 @@ import { type CascadingFilterDto, DashboardDto, type FilterDto, type LayoutDto }
 import type { SpecificWidgetOptions, WidgetsOptions, WidgetsPanelColumnLayout } from './types';
 type WidgetJtdDtoSlice = Pick<WidgetDto, 'oid' | 'type' | 'metadata' | 'drillToDashboardConfig'>;
 export declare const translateLayout: (layout: LayoutDto) => WidgetsPanelColumnLayout;
-export declare function extractDashboardFilters(dashboardFilters: Array<FilterDto | CascadingFilterDto>, filterRelationsModel?: FilterRelationsModel | FilterRelationsModelNode): Filter[] | FilterRelations;
+export declare function extractDashboardFilters(dashboardFilters: Array<FilterDto | CascadingFilterDto>, filterRelationsDtoOptions?: DashboardDto['filterRelations']): Filter[] | FilterRelations;
 export declare const getJtdNavigateType: (widget: WidgetJtdDtoSlice) => TriggerMethod;
 export declare const convertDimensionsToDimIndexes: (widget: WidgetJtdDtoSlice, dimensionIds: string[]) => string[];
 /**

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/use-dashboard-model/dashboard-model-reducer/persist-dashboard-model-middleware.d.ts

@@ -1,4 +1,5 @@
 import { DataSource } from '@sisense/sdk-data';
+import { DashboardModel } from '../../../../../domains/dashboarding/dashboard-model';
 import { RestApi } from '../../../../../infra/api/rest-api';
 import { AppSettings } from '../../../../../infra/app/settings/settings';
 import { CompleteThemeSettingsInternal } from '../../../../../types';
@@ -22,6 +23,14 @@ export type PersistDashboardModelMiddlewareParams = {
      * still satisfies the server's datasource schema.
      */
     dashboardDataSource?: DataSource;
+    /**
+     * Pre-reducer dashboard model snapshot. Used by UPDATE_WIDGET to read
+     * `widgetsOptions[oid].partialDtoOptions.options` so the Fusion PATCH carries
+     * the full options object (Fusion replaces, not merges).
+     *
+     * @internal
+     */
+    model?: DashboardModel;
 };
 /**
  * Middleware that persists the dashboard model changes to the Sisense server.
@@ -29,4 +38,4 @@ export type PersistDashboardModelMiddlewareParams = {
  * @returns Promise resolving to the action (possibly transformed, e.g. for ADD_WIDGET)
  * @internal
  */
-export declare function persistDashboardModelMiddleware({ dashboardOid, action, restApi, sharedMode, appSettings, themeSettings, dashboardDataSource, }: PersistDashboardModelMiddlewareParams): Promise<UseDashboardModelInternalAction>;
+export declare function persistDashboardModelMiddleware({ dashboardOid, action, restApi, sharedMode, appSettings, themeSettings, dashboardDataSource, model, }: PersistDashboardModelMiddlewareParams): Promise<UseDashboardModelInternalAction>;

package/dist/packages/sdk-ui/src/domains/dashboarding/dashboard-model/use-dashboard-model/dashboard-model-reducer/types.d.ts

@@ -1,5 +1,6 @@
 import { Filter, FilterRelations } from '@sisense/sdk-data';
 import { DashboardModel, SpecificWidgetOptions, WidgetsPanelLayout } from '../../../../../domains/dashboarding/dashboard-model';
+import type { WidgetPropsUpdate } from '../../../../../domains/dashboarding/persistence/update-types.js';
 import type { WidgetDto } from '../../../../../domains/widgets/components/widget-by-id/types';
 import { WidgetModel } from '../../../../../domains/widgets/widget-model';
 export type UseDashboardModelState = DashboardModel | null;
@@ -21,6 +22,7 @@ export declare enum UseDashboardModelActionType {
     FILTERS_UPDATE = "FILTERS.UPDATE",
     ADD_WIDGET = "WIDGETS.ADD",
     PATCH_WIDGET = "WIDGETS.PATCH",
+    UPDATE_WIDGET = "WIDGETS.UPDATE",
     WIDGETS_PANEL_LAYOUT_UPDATE = "WIDGETS_PANEL_LAYOUT.UPDATE",
     WIDGETS_DELETE = "WIDGETS.DELETE"
 }
@@ -46,6 +48,18 @@ export type WidgetPatch = {
             max: number;
         };
     };
+    /**
+     * Full opaque widget style to send in the PATCH request. Used for custom
+     * (plugin) widgets whose `styleOptions` round-trip through `WidgetDto.style`.
+     * Must reconstruct the entire style object (the server replaces it on PATCH).
+     */
+    style?: WidgetDto['style'];
+    /**
+     * Full custom-widget options bag to send in the PATCH request.
+     * Must include all existing keys alongside the changed ones, because the
+     * server replaces the entire object rather than merging.
+     */
+    customOptions?: Record<string, unknown>;
 };
 /**
  * Internal actions for the dashboard model state used in {@link useDashboardModel}.
@@ -62,12 +76,26 @@ export type UseDashboardModelInternalAction = UseDashboardModelAction | {
         widgets: string[];
     };
 };
+/**
+ * Props-shaped widget update action. Carries a partial `WidgetPropsUpdate` that
+ * the reducer applies to the in-memory `WidgetModel` and the persist middleware
+ * translates to a targeted DTO patch via its per-field mapping table.
+ *
+ * @internal
+ */
+export type UseDashboardModelUpdateWidgetAction = {
+    type: UseDashboardModelActionType.UPDATE_WIDGET;
+    payload: {
+        widgetOid: string;
+        update: WidgetPropsUpdate;
+    };
+};
 /**
  * Actions for the dashboard model state used in {@link useDashboardModel}.
  *
  * @internal
  */
-export type UseDashboardModelAction = UseDashboardModelFilterUpdateAction | UseDashboardModelAddWidgetAction | UseDashboardModelPatchWidgetAction | UseDashboardModelLayoutUpdateAction | UseDashboardWidgetsDeleteAction;
+export type UseDashboardModelAction = UseDashboardModelFilterUpdateAction | UseDashboardModelAddWidgetAction | UseDashboardModelPatchWidgetAction | UseDashboardModelUpdateWidgetAction | UseDashboardModelLayoutUpdateAction | UseDashboardWidgetsDeleteAction;
 /**
  * Filter update actions for the dashboard model state used in {@link useDashboardModel}.
  *

package/dist/packages/sdk-ui/src/domains/dashboarding/hooks/use-widget-updates-persistence.d.ts

@@ -0,0 +1,27 @@
+import type { DashboardPersistenceManager } from '../../../domains/dashboarding/persistence/types';
+import type { WidgetProps } from '../../../domains/widgets/components/widget/types';
+type Persistence = Pick<DashboardPersistenceManager, 'updateWidget'> | undefined;
+/**
+ * Composition middleware that adds persistable widget-update plumbing to a
+ * widget list. For each widget that exposes a known runtime-state callback
+ * (currently only `styleOptions.navigator.onScrollerChange` for charts with
+ * a navigator), the hook injects a handler that:
+ *
+ * 1. Applies the update optimistically to local widget state (the parent
+ *    `useComposedDashboardInternal` re-renders with the new value).
+ * 2. Schedules a debounced (500 ms) call to `persistence.updateWidget` with
+ *    a {@link WidgetPropsUpdate}-shaped payload.
+ *
+ * When `persistence` is `undefined`, the optimistic apply still runs (so
+ * visualizations behave correctly in read-only mode) and the persist call
+ * is skipped.
+ *
+ * Errors during persistence are logged via `console.error`; the hook does
+ * not roll back local state.
+ *
+ * @sisenseInternal
+ */
+export declare function useWidgetUpdatesPersistence(widgets: WidgetProps[], setWidgets: (updater: (prev: WidgetProps[]) => WidgetProps[]) => void, persistence?: Persistence): {
+    widgets: WidgetProps[];
+};
+export {};

package/dist/packages/sdk-ui/src/domains/dashboarding/persistence/deep-merge.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Deep-merges a partial `update` into `base` for widget-update persistence.
+ *
+ * Merge semantics (shared by every merge point of the unified widget-update
+ * channel — pending-update accumulator, optimistic apply, model reducer and
+ * DTO patch):
+ * - nested plain objects are merged recursively at any depth;
+ * - arrays, primitives and non-plain objects (e.g. `Date`) are replaced
+ *   wholesale (last-write-wins);
+ * - keys cannot be deleted via merge — overwrite with an explicit value
+ *   (e.g. `null`) instead.
+ *
+ * Pure: returns a new object, never mutates the inputs.
+ *
+ * @internal
+ */
+export declare function deepMerge<T extends object>(base: T, update: object): T;

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

@@ -1,5 +1,7 @@
 import type { SpecificWidgetOptions, WidgetPatch, WidgetsPanelLayout } from '../../../domains/dashboarding/dashboard-model';
 import type { WidgetProps } from '../../../domains/widgets/components/widget/types';
+import type { WidgetPropsUpdate } from './update-types.js';
+export type { WidgetPropsUpdate, OnWidgetUpdate } from './update-types.js';
 /**
  * Interface for persisting dashboard changes from the composition layer (e.g. add widget).
  *
@@ -49,4 +51,17 @@ export type DashboardPersistenceManager = {
      * The patch to apply to the widget.
      */
     patch: WidgetPatch) => Promise<void>;
+    /**
+     * Apply a props-shaped partial update to an existing widget. The composition
+     * layer's preferred write channel for visualization-originated state
+     * (scroll, customOptions, future title/description). Internally routed
+     * through the per-field DTO patch table in `persist-dashboard-model-middleware`.
+     *
+     * Fire-and-forget; errors are logged at the call site. The reducer applies
+     * the update to the canonical `WidgetModel` synchronously before the REST
+     * call fires.
+     *
+     * @sisenseInternal
+     */
+    updateWidget: (widgetOid: string, update: WidgetPropsUpdate) => Promise<void>;
 };

package/dist/packages/sdk-ui/src/domains/dashboarding/persistence/update-types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Narrow, props-shaped slice of widget state that can be persisted through the
+ * unified `DashboardPersistenceManager.updateWidget` channel. Intentionally
+ * narrow on first landing — extended only when a new field is paired with a
+ * row in the persist middleware's per-field DTO patch table AND an
+ * update→DTO-patch→re-read roundtrip test.
+ *
+ * For the persistable-vs-transient distinction, see
+ * [unified-widget-updates-persistence.md §6.4](./__dev-docs__/unified-widget-updates-persistence.md).
+ * Transient/interactive events (drilldown selections, in-progress title edits)
+ * stay on the {@link WidgetChangeEvent} channel.
+ *
+ * @sisenseInternal
+ */
+export type WidgetPropsUpdate = {
+    readonly styleOptions?: {
+        readonly navigator?: {
+            readonly scrollerLocation?: {
+                readonly min: number;
+                readonly max: number;
+            };
+        };
+        /**
+         * For custom (plugin) widgets, `styleOptions` is an opaque deeply-partial
+         * bag — arbitrary keys are deep-merged into the widget's opaque DTO
+         * `style` (see `deepMerge` for the semantics). Chart widgets only use the
+         * typed `navigator` subtree above.
+         */
+        readonly [key: string]: unknown;
+    };
+    /**
+     * Custom-widget-specific runtime options to persist. Only meaningful for
+     * custom (plugin) widgets. The middleware deep-merges this into the widget
+     * DTO's `customOptions` bag, preserving any existing keys (at any depth) not
+     * present in the update.
+     *
+     * Only serializable values should be passed — non-serializable values cannot
+     * survive the DTO round-trip.
+     */
+    readonly customOptions?: Readonly<Record<string, unknown>>;
+};
+/**
+ * Callback signature used internally by `useWidgetUpdatesPersistence` to emit
+ * a persistable update for a specific widget. Not part of the public
+ * `WidgetProps` surface — composition layer injects handlers into the
+ * visualization's existing callback APIs (e.g.
+ * `styleOptions.navigator.onScrollerChange`).
+ *
+ * @internal
+ */
+export type OnWidgetUpdate = (update: WidgetPropsUpdate) => void;

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/highchart-based-charts/calendar-heatmap-chart/data.d.ts

@@ -20,7 +20,6 @@ export type CalendarHeatmapChartData = {
  * @param chartDataOptions - Internal data options specifying which columns to use
  * @param dataTable - Raw data table containing the source data
  * @returns Formatted calendar heatmap chart data
-
  */
 export declare function getCalendarHeatmapChartData(chartDataOptions: CalendarHeatmapChartDataOptionsInternal, dataTable: DataTable): CalendarHeatmapChartData;
 /**

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

@@ -1,4 +1,4 @@
-import { CalculatedMeasureColumn, Column, MeasureColumn } from '@sisense/sdk-data';
+import { CalculatedColumn, CalculatedMeasureColumn, Column, MeasureColumn } from '@sisense/sdk-data';
 import { DataColumnNamesMapping } from '../chart-data-options/validate-data-options';
 import { DataTable } from '../chart-data-processor/table-processor';
-export declare const filterAndAggregateChartData: (sourceTable: DataTable, attributes: Column[], measures: (MeasureColumn | CalculatedMeasureColumn)[], dataColumnNamesMapping?: DataColumnNamesMapping) => DataTable;
+export declare const filterAndAggregateChartData: (sourceTable: DataTable, attributes: (Column | CalculatedColumn)[], measures: (MeasureColumn | CalculatedMeasureColumn)[], dataColumnNamesMapping?: DataColumnNamesMapping) => DataTable;

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

@@ -1,5 +1,5 @@
-import { CalculatedMeasureColumn, Column, ForecastFormulaOptions, MeasureColumn, PivotGrandTotals, TotalsCalculation, TrendFormulaOptions } from '@sisense/sdk-data';
-import type { LineWidth, Markers, MultiColumnValueToColorMap, NumberFormatConfig, PivotRowsSort, SeriesChartType, SortDirection, ValueToColorMap } from '../../../../types';
+import { CalculatedColumn, CalculatedMeasureColumn, Column, ForecastFormulaOptions, MeasureColumn, PivotGrandTotals, TotalsCalculation, TrendFormulaOptions } from '@sisense/sdk-data';
+import type { GenericDataOptions, LineWidth, Markers, MultiColumnValueToColorMap, NumberFormatConfig, PivotRowsSort, SeriesChartType, SortDirection, ValueToColorMap } from '../../../../types';
 import { ConditionalDataColorOptions, DataColorOptions, UniformDataColorOptions } from '../chart-data/data-coloring';
 /**
  * Styles for a category/column when visualized in a chart
@@ -99,8 +99,8 @@ export interface CategoryStyle {
  * Also, see {@link StyledMeasureColumn}.
  */
 export interface StyledColumn extends CategoryStyle {
-    /** Wrapped Column */
-    column: Column;
+    /** Wrapped Column or CalculatedColumn (calculated dimension) */
+    column: Column | CalculatedColumn;
 }
 /**
  * Styles for a value/measure when it is visualized in a chart.
@@ -237,7 +237,7 @@ export interface StyledMeasureColumn extends ValueStyle, SeriesStyle {
 /**
  * @internal
  */
-export type AnyColumn = Column | StyledColumn | MeasureColumn | StyledMeasureColumn | CalculatedMeasureColumn;
+export type AnyColumn = Column | CalculatedColumn | StyledColumn | MeasureColumn | StyledMeasureColumn | CalculatedMeasureColumn;
 /**
  * Configuration for how to query aggregate data and assign data
  * to axes of a {@link CartesianChartType | Cartesian chart}.
@@ -251,7 +251,7 @@ export interface CartesianChartDataOptions {
      *
      * Typically, the X-axis represents descriptive data.
      */
-    category: (Column | StyledColumn)[];
+    category: (Column | CalculatedColumn | StyledColumn)[];
     /**
      * Measure columns (or measures) whose values are scaled to the Y-axis of the chart.
      *
@@ -265,7 +265,7 @@ export interface CartesianChartDataOptions {
      * Each group is represented by a different visual encoding - for example, color of bars in a bar chart,
      * and is automatically added to the chart's legend.
      */
-    breakBy: (Column | StyledColumn)[];
+    breakBy: (Column | CalculatedColumn | StyledColumn)[];
     /**
      * Optional mapping of each of the series to colors.
      */
@@ -288,7 +288,7 @@ export interface CategoricalChartDataOptions {
      *
      * For funnel charts, only the first 50 categories will be used.
      */
-    category: (Column | StyledColumn)[];
+    category: (Column | CalculatedColumn | StyledColumn)[];
     /**
      * Optional mapping of each of the series to colors.
      * ({@link MultiColumnValueToColorMap} used only for the Sunburst Chart component)
@@ -323,14 +323,14 @@ export interface ScatterChartDataOptions {
      * Typically, the X-axis of a Scatter Chart is used to represent numeric data.
      * Alternatively, Descriptive data is also supported. At most one column is allowed.
      */
-    x?: Column | StyledColumn | MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
+    x?: Column | CalculatedColumn | StyledColumn | MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
     /**
      * A column or measure column whose values are placed on the Y-axis.
      *
      * Typically, the Y-axis of a Scatter Chart is used to represent numeric data.
      * Alternatively, Descriptive data is also supported. At most one column is allowed.
      */
-    y?: Column | StyledColumn | MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
+    y?: Column | CalculatedColumn | StyledColumn | MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
     /**
      * A column to be scattered across the chart as circles;
      * one point (circle) appears on the chart for each member of this column.
@@ -338,7 +338,7 @@ export interface ScatterChartDataOptions {
      *
      * You can only add a break-by point if either the X-axis or the Y-axis was defined to represent numeric data.
      */
-    breakByPoint?: Column | StyledColumn;
+    breakByPoint?: Column | CalculatedColumn | StyledColumn;
     /**
      * Select a column by which to break (group) the columns in the chart.
      * This must be a descriptive column. If you select descriptive data,
@@ -353,7 +353,7 @@ export interface ScatterChartDataOptions {
      * the darkest color and the lowest value is the lightest color.
      *
      */
-    breakByColor?: Column | StyledColumn | MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
+    breakByColor?: Column | CalculatedColumn | StyledColumn | MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
     /**
      * Column that determines the size of the circle. It must be numeric data.
      *
@@ -370,7 +370,7 @@ export interface ScatterChartDataOptions {
  */
 export interface AreamapChartDataOptions {
     /** Column or attribute representing the countries (or states) on the map. */
-    geo: [Column | StyledColumn];
+    geo: [Column | CalculatedColumn | StyledColumn];
     /** Measure column (or measure) encoded by the color of the countries (or states) on the map. */
     color?: [MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn];
 }
@@ -380,7 +380,7 @@ export interface AreamapChartDataOptions {
  */
 export interface CalendarHeatmapChartDataOptions {
     /** Date column representing dates on the calendar heatmap. */
-    date: Column | StyledColumn;
+    date: Column | CalculatedColumn | StyledColumn;
     /** Measure column (or measure) assigned to the calendar cells. */
     value: MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
 }
@@ -391,7 +391,7 @@ export interface TableDataOptions {
     /**
      * Columns (or attributes) whose values represent data columns in table
      */
-    columns: (Column | StyledColumn | MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn)[];
+    columns: (Column | CalculatedColumn | StyledColumn | MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn)[];
 }
 /**
  * Configuration for how to query data and assign data to tabular charts.
@@ -407,13 +407,13 @@ export interface PivotTableDataOptions {
      *
      * @category Data Options
      */
-    rows?: (Column | StyledColumn)[];
+    rows?: (Column | CalculatedColumn | StyledColumn)[];
     /**
      * Dimensions for the columns of the pivot table
      *
      * @category Data Options
      */
-    columns?: (Column | StyledColumn)[];
+    columns?: (Column | CalculatedColumn | StyledColumn)[];
     /**
      * Measures for the values of the pivot table
      *
@@ -446,7 +446,7 @@ export interface ScattermapChartDataOptions {
      * Support field(s) that contain geographic data (Country, City, State/Province, etc)
      * To visualize latitude and longitude data, you have to add one field containing latitude data, and another field containing longitude data, in this order.
      */
-    geo: (Column | StyledColumn)[];
+    geo: (Column | CalculatedColumn | StyledColumn)[];
     /**
      * Measure column (or measure) representing the size of the points on the map.
      */
@@ -458,7 +458,7 @@ export interface ScattermapChartDataOptions {
     /**
      * Column or measure column representing the additional details for the points on the map.
      */
-    details?: Column | StyledColumn | MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
+    details?: Column | CalculatedColumn | StyledColumn | MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
 }
 /**
  * Represents the type of box whisker data algorithm, which can be either `iqr`, `extremums`, or `standardDeviation`.
@@ -475,7 +475,7 @@ export type BoxplotChartDataOptions = {
     /**
      * Columns (or attributes) whose values represent categories in the chart.
      */
-    category: [(Column | StyledColumn)?];
+    category: [(Column | CalculatedColumn | StyledColumn)?];
     /**
      * Columns (or attributes) whose values represent the target numeric value column for computing boxplot metrics according to the selected `boxType`
      */
@@ -500,7 +500,7 @@ export type BoxplotChartCustomDataOptions = {
     /**
      * Columns (or attributes) whose values represent categories in the chart.
      */
-    category: [(Column | StyledColumn)?];
+    category: [(Column | CalculatedColumn | StyledColumn)?];
     /**
      * Measure columns (or measures) representing the target numeric values used for computing boxplot metrics.
      */
@@ -530,7 +530,7 @@ export interface RangeChartDataOptions {
      *
      * Typically, the X-axis represents descriptive data.
      */
-    category: (Column | StyledColumn)[];
+    category: (Column | CalculatedColumn | StyledColumn)[];
     /**
      * An array of measure columns used to represent the target numeric values for computing the metrics
      * in an area range chart.
@@ -545,7 +545,7 @@ export interface RangeChartDataOptions {
      * Each group is represented by a different visual encoding - for example, color of bars in a bar chart,
      * and is automatically added to the chart's legend.
      */
-    breakBy: (Column | StyledColumn)[];
+    breakBy: (Column | CalculatedColumn | StyledColumn)[];
     /**
      * Optional mapping of each of the series to colors.
      */
@@ -564,6 +564,10 @@ export interface RangeChartDataOptions {
  * {@link ScattermapChartDataOptions | Scattermap} charts.
  */
 export type ChartDataOptions = RegularChartDataOptions | TabularChartDataOptions;
+/**
+ * Union of data options for all supported CSDK visualization (chart) types
+ */
+export type CommonDataOptions = ChartDataOptions | PivotTableDataOptions | GenericDataOptions;
 /**
  * Configuration for how to query aggregate data and assigning data to chart encodings of regular charts.
  */

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

@@ -1,4 +1,4 @@
-import { Attribute, CalculatedMeasureColumn, Column, Measure, MeasureColumn } from '@sisense/sdk-data';
+import { Attribute, CalculatedColumn, CalculatedMeasureColumn, Column, Measure, MeasureColumn } from '@sisense/sdk-data';
 import { AnyColumn, CategoryStyle, StyledColumn, StyledMeasureColumn, ValueStyle } from './types.js';
 type AnyObject = Record<string, any>;
 /**
@@ -21,7 +21,7 @@ export declare const safeMerge: <T extends AnyObject, S extends AnyObject>(sourc
  */
 export declare const safeCombine: <T extends AnyObject>(sourceWithInheritance: T, sourceToAbsorb: AnyObject) => T;
 export declare const splitColumn: <C extends AnyColumn>(targetColumn: C) => {
-    column: Column | MeasureColumn | CalculatedMeasureColumn;
+    column: Column | MeasureColumn | CalculatedMeasureColumn | CalculatedColumn;
     style: CategoryStyle | ValueStyle;
 } | {
     column: C;
@@ -44,7 +44,7 @@ export declare function isMeasureColumn(arg: AnyColumn): arg is MeasureColumn |
 export declare const getDataOptionTitle: (styledColumn: StyledColumn | StyledMeasureColumn) => string;
 export declare const getDataOptionGranularity: ({ column, granularity }: StyledColumn) => string;
 /** @internal */
-export declare const translateColumnToAttribute: (c: Column | StyledColumn) => Attribute;
+export declare const translateColumnToAttribute: (c: Column | CalculatedColumn | StyledColumn) => Attribute;
 export declare const translateColumnToMeasure: (c: MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn) => Measure;
 /**
  * Checks if column is a StyledColumns.
@@ -60,7 +60,7 @@ export declare function isStyledColumn(targetColumn: AnyColumn): targetColumn is
  * @internal
  */
 export declare function isCategoryStyle(category: Column | CategoryStyle): category is CategoryStyle;
-export declare function normalizeColumn(targetColumn: Column | StyledColumn, defaultStyle?: CategoryStyle): StyledColumn;
+export declare function normalizeColumn(targetColumn: Column | CalculatedColumn | StyledColumn, defaultStyle?: CategoryStyle): StyledColumn;
 export declare function normalizeMeasureColumn(targetColumn: MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn, defaultStyle?: ValueStyle): StyledMeasureColumn;
 export declare function normalizeAnyColumn(targetColumn: AnyColumn, defaultStyle?: CategoryStyle | ValueStyle): StyledColumn | StyledMeasureColumn;
 export {};

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

@@ -0,0 +1,14 @@
+import type { Filter } from '@sisense/sdk-data';
+/**
+ * Builds a human-readable one-line label for a {@link Filter}, covering common
+ * `filterType` variants (`members`, `exclude`, `text`, `numeric`, `dateRange`, etc.).
+ *
+ * Discrimination uses the `filterType` string rather than `instanceof` so the helper
+ * stays robust when multiple `@sisense/sdk-data` copies exist in a workspace.
+ *
+ * @param filter - Filter instance to describe
+ * @param attributeName - Optional display name override (e.g. i18n date-level label)
+ * @returns Readable pill label; falls back to the attribute name when composition fails
+ * @sisenseInternal
+ */
+export declare function toReadableFilterLabel(filter: Filter, attributeName?: string): string;

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

@@ -3,6 +3,7 @@ export type { QueryDefinitionProps } from './query-definition';
 export { QueryPill } from './query-pill';
 export type { QueryPillProps } from './query-pill';
 export { baseQueryParamsToViewModel } from './query-params-to-view-model';
+export { toReadableFilterLabel } from './filter-to-readable-label';
 export { getQueryPillTooltipModel } from './compose-code-to-readable';
 export type { TooltipModel } from './compose-code-to-readable';
 export type { QueryPillCategory, QueryPillItem, ConnectorItem, QueryDefinitionViewModel, } from './types';

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

@@ -16,6 +16,11 @@ export interface QueryDefinitionProps {
      * root is only one row tall and must not be used as boundary (breaks vertical placement).
      */
     tooltipBoundaryElement?: HTMLElement | null;
+    /**
+     * Maximum number of characters shown in each pill label before truncation (default `25`).
+     * Pass `0` to show the full label.
+     */
+    maxPillLength?: number;
 }
 /**
  * Read-only query definition as colored pills above the widget.

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

@@ -9,6 +9,11 @@ export interface QueryPillProps {
     item: QueryPillItem;
     showTooltip?: boolean;
     tooltipBoundaryElement?: HTMLElement | null;
+    /**
+     * Maximum number of characters shown in the pill label before truncation.
+     * When `0` or omitted, the full label is shown.
+     */
+    maxLength?: number;
 }
 /**
  * Read-only query-definition pill; JSON tooltip is a portal bubble with a real triangle.

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

@@ -0,0 +1,10 @@
+/**
+ * Truncates a pill label when it exceeds `maxLength`. When `maxLength` is zero or negative,
+ * the label is returned unchanged.
+ *
+ * @param label - Full pill label
+ * @param maxLength - Maximum number of characters before truncation; `0` disables truncation
+ * @returns Truncated label with an ellipsis suffix when shortened
+ * @internal
+ */
+export declare function truncatePillLabel(label: string, maxLength: number): string;

package/dist/packages/sdk-ui/src/domains/widgets/change-events.d.ts

@@ -69,5 +69,11 @@ export type PivotTableWidgetChangeEvent = PivotTableWidgetDrilldownSelectionsCha
  *   }
  * }}
  * ```
+ *
+ * Persistable state changes (e.g. scroll position, future title/customOptions)
+ * flow through {@link WidgetPropsUpdate} and `DashboardPersistenceManager.updateWidget`,
+ * NOT through this channel. Use `WidgetChangeEvent` for transient/interactive
+ * events; use `WidgetPropsUpdate` for "if this is lost on reload, the user
+ * notices."
  */
 export type WidgetChangeEvent = ChartWidgetChangeEvent | PivotTableWidgetChangeEvent;

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

@@ -1,4 +1,5 @@
 import { DataSource, Filter, FilterRelations } from '@sisense/sdk-data';
+import type { VisualizationStateUpdate } from '../../../../infra/plugins/widget-plugins/types';
 import { CustomWidgetEventProps, CustomWidgetStyleOptions, GenericDataOptions } from '../../../../types';
 import { WidgetConfig } from '../widget/types';
 /**
@@ -77,4 +78,14 @@ export interface CustomWidgetProps extends CustomWidgetEventProps {
      * @category Widget
      */
     customOptions?: Record<string, any>;
+    /**
+     * Emit a partial state update to be persisted through the dashboard
+     * persistence layer. Injected by the dashboard composition layer
+     * (`useWidgetUpdatesPersistence`) and forwarded to the plugin visualization
+     * component as {@link CustomVisualizationProps.onChange}.
+     *
+     * @category Widget
+     * @internal
+     */
+    onChange?: (update: VisualizationStateUpdate) => void;
 }

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

@@ -1,5 +1,20 @@
 import { type FunctionComponent } from 'react';
 import { PivotTableWidgetProps } from './types';
+/**
+ * Computes the outer widget height in auto-height mode.
+ *
+ * The inner pivot reports only its own table height. The widget reserves additional vertical
+ * space above the pivot — the container chrome (header + `spaceAround` padding, SNS-127785) and
+ * the optional top slot (e.g. drilldown breadcrumbs, SNS-128141). Callers must sum all such
+ * non-pivot reserved space into `reservedHeight` so that pagination at the bottom of the pivot
+ * remains reachable.
+ *
+ * @param pivotTableHeight - The measured content height of the pivot table.
+ * @param reservedHeight - The total non-pivot vertical space the widget reserves (chrome + topSlot).
+ * @returns The total widget height in pixels, or `undefined` when the content height is unknown.
+ * @internal
+ */
+export declare function calcPivotTableWidgetHeight(pivotTableHeight: number | undefined, reservedHeight: number): number | undefined;
 /**
  * React component extending `PivotTable` to support widget style options.
  *