@sisense/sdk-ui 2.25.0 → 2.26.0

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

@@ -1,3 +1,4 @@
+import type { TFunction } from '@sisense/sdk-common';
 import type { BaseQueryParams } from '../../../../domains/query-execution/types';
 import type { QueryDefinitionViewModel } from './types';
 /**
@@ -6,7 +7,10 @@ import type { QueryDefinitionViewModel } from './types';
  * Operators (comparison/sort) are not derived from BaseQueryParams in v1.
  *
  * @param params - BaseQueryParams from chart or query
+ * @param t - Optional i18n translate function. When provided, date-level (`DimensionalLevelAttribute`)
+ *   dimensions and filters use `attribute.datetimeName.*` strings (e.g. "Months in Date"). When omitted,
+ *   labels match the previous behavior (`attr.name` only).
  * @returns QueryDefinitionViewModel (pills and connectors)
- * @internal
+ * @sisenseInternal
  */
-export declare function baseQueryParamsToViewModel(params: BaseQueryParams): QueryDefinitionViewModel;
+export declare function baseQueryParamsToViewModel(params: BaseQueryParams, t?: TFunction): QueryDefinitionViewModel;

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

@@ -1,5 +1,10 @@
 import type { FunctionComponent } from 'react';
 import type { QueryPillItem } from './types';
+/**
+ * Props for {@link QueryPill}.
+ *
+ * @sisenseInternal
+ */
 export interface QueryPillProps {
     item: QueryPillItem;
     showTooltip?: boolean;
@@ -8,6 +13,6 @@ export interface QueryPillProps {
 /**
  * Read-only query-definition pill; JSON tooltip is a portal bubble with a real triangle.
  *
- * @internal
+ * @sisenseInternal
  */
 export declare const QueryPill: FunctionComponent<QueryPillProps>;

package/dist/packages/sdk-ui/src/domains/widgets/components/widget-by-id/translate-widget-style-options/to-widget-dto-style.d.ts

@@ -1,6 +1,7 @@
+import type { PivotGrandTotals } from '@sisense/sdk-data';
 import { AppSettings } from '../../../../../infra/app/settings/settings.js';
-import type { AreaStyleOptions, AxisLabel, CompleteThemeSettings, DataLimits, IndicatorStyleOptions, LegendOptions, LineStyleOptions, LineWidth, Markers, Navigator, PieStyleOptions, SeriesLabels, WidgetStyleOptions } from '../../../../../types.js';
-import type { AxisStyle, CartesianWidgetStyle, WidgetDesign, WidgetStyle, WidgetSubtype } from '../types.js';
+import type { AreamapType, AreaStyleOptions, AxisLabel, CompleteThemeSettings, DataLimits, FunnelStyleOptions, IndicatorStyleOptions, LegendOptions, LineStyleOptions, LineWidth, Markers, Navigator, PieStyleOptions, PivotTableWidgetStyleOptions, PolarStyleOptions, ScattermapStyleOptions, ScatterStyleOptions, SeriesLabels, StackableStyleOptions, SunburstStyleOptions, TableStyleOptions, TreemapStyleOptions, WidgetStyleOptions } from '../../../../../types.js';
+import type { AxisStyle, CartesianWidgetStyle, FunnelWidgetStyle, PivotWidgetStyle, PolarWidgetStyle, ScattermapWidgetStyle, ScatterWidgetStyle, SunburstWidgetStyle, TableWidgetStyle, TreemapWidgetStyle, WidgetDesign, WidgetStyle, WidgetSubtype } from '../types.js';
 /**
  * Maps SDK legend options to Fusion DTO legend style.
  *
@@ -117,4 +118,119 @@ export declare function toLineWidgetStyle(styleOptions: LineStyleOptions): Carte
  * @returns Fusion CartesianWidgetStyle for the widget DTO
  */
 export declare function toAreaWidgetStyle(styleOptions: AreaStyleOptions, widgetSubtype: WidgetSubtype): CartesianWidgetStyle;
+/**
+ * Converts funnel chart style options to Fusion FunnelWidgetStyle DTO.
+ * Inverse of {@link extractFunnelChartStyleOptions}.
+ *
+ * @param styleOptions - Funnel style options from WidgetModel.styleOptions
+ * @returns Fusion FunnelWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toFunnelWidgetStyle(styleOptions: FunnelStyleOptions): FunnelWidgetStyle;
+/**
+ * Converts treemap chart style options to Fusion TreemapWidgetStyle DTO.
+ * Inverse of {@link extractTreemapChartStyleOptions}.
+ *
+ * @param styleOptions - Treemap style options from WidgetModel.styleOptions
+ * @returns Fusion TreemapWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toTreemapWidgetStyle(styleOptions: TreemapStyleOptions): TreemapWidgetStyle;
+/**
+ * Converts sunburst chart style options to Fusion SunburstWidgetStyle DTO.
+ * Inverse of {@link extractSunburstChartStyleOptions}.
+ *
+ * @param styleOptions - Sunburst style options from WidgetModel.styleOptions
+ * @returns Fusion SunburstWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toSunburstWidgetStyle(styleOptions: SunburstStyleOptions): SunburstWidgetStyle;
+/**
+ * Converts bar chart style options to Fusion CartesianWidgetStyle DTO.
+ * Used when serializing a bar chart widget back to WidgetDto.
+ *
+ * @param styleOptions - Bar/stackable style options from WidgetModel.styleOptions
+ * @param widgetSubtype - Resolved Fusion widget subtype (e.g. 'bar/classic', 'bar/stacked', 'bar/stacked100')
+ * @returns Fusion CartesianWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toBarWidgetStyle(styleOptions: StackableStyleOptions, widgetSubtype: WidgetSubtype): CartesianWidgetStyle;
+/**
+ * Converts column chart style options to Fusion CartesianWidgetStyle DTO.
+ * Used when serializing a column chart widget back to WidgetDto.
+ *
+ * @param styleOptions - Column/stackable style options from WidgetModel.styleOptions
+ * @param widgetSubtype - Resolved Fusion widget subtype (e.g. 'column/classic', 'column/stackedcolumn', 'column/stackedcolumn100')
+ * @returns Fusion CartesianWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare const toColumnWidgetStyle: typeof toBarWidgetStyle;
+/**
+ * Converts polar chart style options to Fusion PolarWidgetStyle DTO.
+ * Uses `categories` / `axis` field names (instead of `xAxis` / `yAxis` used by Cartesian charts).
+ * Used when serializing a polar chart widget back to WidgetDto.
+ *
+ * @param styleOptions - Polar style options from WidgetModel.styleOptions
+ * @returns Fusion PolarWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toPolarWidgetStyle(styleOptions: PolarStyleOptions): PolarWidgetStyle;
+/**
+ * Maps SDK scatter marker size to Fusion DTO marker size style.
+ * Inverse of the extraction performed by `extractScatterChartStyleOptions`.
+ *
+ * @internal
+ */
+export declare function toScatterMarkerSizeStyle(markerSize?: ScatterStyleOptions['markerSize']): ScatterWidgetStyle['markerSize'];
+/**
+ * Converts scatter chart style options to Fusion ScatterWidgetStyle DTO.
+ * Inverse of `extractScatterChartStyleOptions`.
+ *
+ * @param styleOptions - Scatter style options from WidgetModel.styleOptions
+ * @returns Fusion ScatterWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toScatterWidgetStyle(styleOptions: ScatterStyleOptions): ScatterWidgetStyle;
+/**
+ * Converts scattermap style options to Fusion ScattermapWidgetStyle DTO.
+ * Inverse of `extractScattermapChartStyleOptions`. Missing SDK fields fall back
+ * to Fusion's scattermap defaults so the emitted DTO always carries a fully
+ * populated `markers` object (Fusion assumes it is always set).
+ *
+ * @param styleOptions - Scattermap style options from WidgetModel.styleOptions
+ * @returns Fusion ScattermapWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toScattermapWidgetStyle(styleOptions: ScattermapStyleOptions): ScattermapWidgetStyle;
+/**
+ * Maps an SDK areamap `mapType` to the Fusion widget subtype used as the DTO
+ * `subtype` field. Inverse of the `subtype → mapType` mapping performed by
+ * {@link extractAreamapChartStyleOptions}. Defaults to `areamap/world` when
+ * `mapType` is unset or unrecognized — matching Fusion default.
+ *
+ * @internal
+ */
+export declare function toAreamapSubtype(mapType?: AreamapType): 'areamap/world' | 'areamap/usa';
+/**
+ * Converts table style options to Fusion TableWidgetStyle DTO.
+ * Used when serializing a table widget back to WidgetDto.
+ *
+ * @param styleOptions - Table style options from WidgetModel.styleOptions
+ * @returns Fusion TableWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toTableWidgetStyle(styleOptions: TableStyleOptions): TableWidgetStyle;
+/**
+ * Converts pivot table style options to Fusion PivotWidgetStyle DTO.
+ * Inverse of {@link extractPivotTableStyleOptions}.
+ *
+ * Grand totals come from {@link PivotTableDataOptions.grandTotals} in the WidgetModel, not
+ * from `styleOptions`, so they are passed in separately.
+ *
+ * @param styleOptions - Pivot table style options from WidgetModel.styleOptions
+ * @param grandTotals - Grand totals config from WidgetModel.dataOptions.grandTotals
+ * @returns Fusion PivotWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toPivotTableWidgetStyle(styleOptions: PivotTableWidgetStyleOptions, grandTotals?: PivotGrandTotals): PivotWidgetStyle;
 export {};

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

@@ -236,6 +236,15 @@ export type PanelItem = {
         databars?: boolean;
         width?: number;
         colorIndex?: number;
+        /**
+         * Marker-size range carried on the `size` panel item of a scattermap widget.
+         * Fusion reads `items[0].format.size.min/max` and overwrites `style.markers.size.min/max`
+         * at widget load — so this is the source of truth for rendered marker sizes.
+         */
+        size?: {
+            min?: number;
+            max?: number;
+        };
     };
     jaql: WidgetJaql;
     disabled?: boolean;
@@ -522,6 +531,15 @@ export type ScattermapWidgetStyle = WidgetContainerStyleOptions & {
             defaultSize: number;
             min: number;
             max: number;
+            /**
+             * Fusion-internal UI state / slider bounds. Not read by the renderer but
+             * present on widgets produced by the Fusion wizard, so they are included
+             * when writing the DTO so round-trips keep them intact.
+             */
+            inactive?: boolean;
+            lowest?: number;
+            highest?: number;
+            step?: number;
         };
     };
 };

package/dist/packages/sdk-ui/src/domains/widgets/components/widget-by-id/use-scroller-location-save.d.ts

@@ -0,0 +1,8 @@
+import type { WidgetDto } from '../../../../domains/widgets/components/widget-by-id/types';
+/**
+ * Returns a debounced function that persists the navigator scroller position
+ * for the given widget via a PATCH to the dashboard API.
+ *
+ * @internal
+ */
+export declare function useScrollerLocationSave(dashboardOid: string, widgetOid: string, currentOptions?: NonNullable<WidgetDto['options']>): (min: number, max: number) => void;

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

@@ -11,6 +11,15 @@ import { TextWidgetProps } from '../text-widget/types';
 import { WidgetProps, WidgetType, WithCommonWidgetProps } from '../widget/types';
 import { CsdkPluginWidgetType, FusionPluginWidgetType, FusionWidgetType, Panel, PanelItem, TextWidgetDtoStyle, WidgetStyle, WidgetSubtype } from './types.js';
 export { mergeFilters, getFilterRelationsFromJaql, convertFilterRelationsModelToJaql, getFilterCompareId, } from '@sisense/sdk-data';
+/**
+ * Returns `true` when a panel item's jaql represents a measure — either a base-measure
+ * aggregation (`jaql.agg`) or a calculated measure (`jaql.formula`). Mirrors Fusion's
+ * `isMeasure` dimension helper so CSDK code can evaluate the same "is measure?" checks
+ * Fusion's widget manifests rely on.
+ *
+ * @internal
+ */
+export declare function isMeasurePanelItem(item: PanelItem): boolean;
 /**
  * Returns the corresponding chart type for a given widget type
  *

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

@@ -15,8 +15,8 @@ import { WidgetByIdProps } from '../../../../props.js';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=fusion-assets%2Ffusion-widgets&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/widgets/components/widget-by-id/with-navigator-scroll-save.d.ts

@@ -0,0 +1,10 @@
+import type { WidgetProps } from '../widget/types';
+/**
+ * Injects the navigator scroller-change callback into the widget's navigator style options.
+ * Only activates when the widget has a navigator configuration so the event handler is not
+ * registered on charts that never show the navigator.
+ *
+ * @param onScrollerChange - Invoked with navigator min/max when the scroller moves.
+ * @returns Widget props transformer for use in a `flow` pipeline.
+ */
+export declare function withNavigatorScrollSave(onScrollerChange: (min: number, max: number) => void): (widgetProps: WidgetProps) => WidgetProps;

package/dist/packages/sdk-ui/src/domains/widgets/widget-model/use-get-widget-model.d.ts

@@ -79,8 +79,8 @@ export type WidgetModelSuccessState = {
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=fusion-assets%2Fuse-get-widget-model&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/widgets/widget-model/widget-model-translator/to-widget-dto-panels.d.ts

@@ -0,0 +1,170 @@
+import { AreamapChartDataOptions, CartesianChartDataOptions, CategoricalChartDataOptions, IndicatorChartDataOptions, PivotTableDataOptions, ScatterChartDataOptions, ScattermapChartDataOptions, TableDataOptionsInternal } from '../../../../domains/visualizations/core/chart-data-options/types.js';
+import { Panel } from '../../../../domains/widgets/components/widget-by-id/types.js';
+import { ScattermapStyleOptions } from '../../../../types.js';
+/**
+ * Builds DTO panels for a line chart widget. The category panel is named `x-axis`,
+ * matching the Fusion convention for line/area charts.
+ *
+ * @param dataOptions - Cartesian chart data options from the WidgetModel
+ * @returns Fusion panels: x-axis, values, break by
+ * @internal
+ */
+export declare function toLinePanels(dataOptions: CartesianChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for an area chart widget. The category panel is named `x-axis`,
+ * matching the Fusion convention for line/area charts.
+ *
+ * @param dataOptions - Cartesian chart data options from the WidgetModel
+ * @returns Fusion panels: x-axis, values, break by
+ * @internal
+ */
+export declare function toAreaPanels(dataOptions: CartesianChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a bar chart widget. The category panel is named `categories`.
+ *
+ * @param dataOptions - Cartesian chart data options from the WidgetModel
+ * @returns Fusion panels: categories, values, break by
+ * @internal
+ */
+export declare function toBarPanels(dataOptions: CartesianChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a column chart widget. The category panel is named `categories`.
+ *
+ * @param dataOptions - Cartesian chart data options from the WidgetModel
+ * @returns Fusion panels: categories, values, break by
+ * @internal
+ */
+export declare function toColumnPanels(dataOptions: CartesianChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a polar chart widget. The category panel is named `categories`.
+ *
+ * @param dataOptions - Cartesian chart data options from the WidgetModel
+ * @returns Fusion panels: categories, values, break by
+ * @internal
+ */
+export declare function toPolarPanels(dataOptions: CartesianChartDataOptions): Panel[];
+/**
+ * Builds the single `columns` panel for a table widget. Attributes are emitted first,
+ * then measure columns, preserving the order produced by {@link getTableAttributesAndMeasures}.
+ *
+ * @param dataOptions - Internal table data options from the WidgetModel
+ * @returns Single-element array with the `columns` panel
+ * @internal
+ */
+export declare function toTablePanels(dataOptions: TableDataOptionsInternal): Panel[];
+/**
+ * Builds DTO panels for an indicator widget. Emits `value`, `min`, `max`, and `secondary`
+ * panels in that order; a panel is emitted even when its backing list is empty so that
+ * the DTO panel order is stable across widgets.
+ *
+ * @param dataOptions - Indicator chart data options from the WidgetModel
+ * @returns Fusion panels: value, min, max, secondary
+ * @internal
+ */
+export declare function toIndicatorPanels(dataOptions: IndicatorChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a pie chart widget. Category items carry `format.members` when
+ * a flat `seriesToColorMap` is present so per-slice colors round-trip.
+ *
+ * @param dataOptions - Categorical chart data options from the WidgetModel
+ * @returns Fusion panels: categories, values
+ * @internal
+ */
+export declare function toPiePanels(dataOptions: CategoricalChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a funnel chart widget. Category items carry `format.members` when
+ * a flat `seriesToColorMap` is present so per-step colors round-trip.
+ *
+ * @param dataOptions - Categorical chart data options from the WidgetModel
+ * @returns Fusion panels: categories, values
+ * @internal
+ */
+export declare function toFunnelPanels(dataOptions: CategoricalChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a sunburst chart widget. Each category item carries the nested
+ * `format.members` entry matching its column title so per-level colors round-trip.
+ *
+ * @param dataOptions - Categorical chart data options from the WidgetModel
+ * @returns Fusion panels: categories, values
+ * @internal
+ */
+export declare function toSunburstPanels(dataOptions: CategoricalChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a treemap chart widget. The measures panel is renamed to `size`
+ * and an extra `color` panel is emitted (see {@link toTreemapColorPanel}) so Fusion can
+ * restore the per-value color assignments.
+ *
+ * @param dataOptions - Categorical chart data options from the WidgetModel
+ * @returns Fusion panels: categories, size, color
+ * @internal
+ */
+export declare function toTreemapPanels(dataOptions: CategoricalChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a scatter chart widget. All panels declared by the Fusion
+ * scatter manifest are always emitted (in this exact order: x-axis, y-axis, point,
+ * Break By / Color, size), even when no column is configured — Fusion's renderer
+ * accesses panels by name and throws "the panel '<name>' was not found" when a
+ * declared panel is missing. Slots without a column are emitted with `items: []`.
+ *
+ * Slot names are remapped to Fusion's conventions: `x`→`x-axis`, `y`→`y-axis`,
+ * `breakByPoint`→`point`, `breakByColor`→`Break By / Color`, `size`→`size`.
+ *
+ * When a flat `seriesToColorMap` is present and `breakByColor` has a column, its
+ * entries are attached to the `Break By / Color` item as `format.members` so
+ * Fusion restores the per-series colors on round-trip.
+ *
+ * @param dataOptions - Scatter chart data options from the WidgetModel
+ * @returns Fusion panels in fixed order; every declared panel is always present
+ * @internal
+ */
+export declare function toScatterPanels(dataOptions: ScatterChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a pivot table widget: `rows`, `columns`, and `values` (in that
+ * order). Rows and columns are treated as attributes; values as measures. Grand totals
+ * live on the style in the DTO and are written separately by
+ * {@link toPivotTableWidgetStyle}.
+ *
+ * @param dataOptions - Pivot table data options from the WidgetModel
+ * @returns Fusion panels: rows, columns, values
+ * @internal
+ */
+export declare function toPivotTablePanels(dataOptions: PivotTableDataOptions): Panel[];
+/**
+ * Builds DTO panels for a scattermap chart widget. All panels declared by the
+ * Fusion scattermap manifest are always emitted (in this exact order: `geo`,
+ * `color`, `size`, `details`), even when a slot has no column — Fusion's
+ * renderer accesses panels by name and throws "the panel '<name>' was not found"
+ * when a declared panel is missing. Slots without a column are emitted with
+ * `items: []`.
+ *
+ * Each geo item carries its `geoLevel` when the styled column supplies one so
+ * the country/state/city level round-trips. `color` holds a single measure
+ * (range-colored in Fusion), `size` holds a single measure, `details` holds a
+ * single attribute or measure.
+ *
+ * The size panel item additionally carries `format.size = { min, max }` when
+ * marker-size options are provided. Fusion reads `items[0].format.size.min/max` at widget load and overwrites
+ * `style.markers.size.min/max`, so this item-level format is the source of truth
+ * for rendered marker sizes — emitting the style alone is not enough.
+ *
+ * @param dataOptions - Scattermap chart data options from the WidgetModel
+ * @param markerSize - Optional marker-size options from WidgetModel.styleOptions.markers.size
+ * @returns Fusion panels in fixed order; every declared panel is always present
+ * @internal
+ */
+export declare function toScattermapPanels(dataOptions: ScattermapChartDataOptions, markerSize?: NonNullable<ScattermapStyleOptions['markers']>['size']): Panel[];
+/**
+ * Builds DTO panels for an areamap chart widget. All panels declared by the
+ * Fusion areamap manifest are always emitted (in this exact order: `geo`,
+ * `color`), even when a slot has no column — Fusion's renderer accesses panels
+ * by name and throws "the panel '<name>' was not found" when a declared panel
+ * is missing. Slots without a column are emitted with `items: []`.
+ *
+ * The geo slot is a single attribute (country/state). The color slot is a
+ * single measure; Fusion's manifest range-colors it at render time.
+ *
+ * @param dataOptions - Areamap chart data options from the WidgetModel
+ * @returns Fusion panels in fixed order; every declared panel is always present
+ * @internal
+ */
+export declare function toAreamapPanels(dataOptions: AreamapChartDataOptions): Panel[];

package/dist/packages/sdk-ui/src/domains/widgets/widget-model/widget-model-translator/widget-model-translator.d.ts

@@ -4,7 +4,6 @@ import { ChartWidgetProps } from '../../../../domains/widgets/components/chart-w
 import { CommonWidgetProps } from '../../../../domains/widgets/components/common-widget/types';
 import { CustomWidgetProps } from '../../../../domains/widgets/components/custom-widget/types';
 import { PivotTableWidgetProps } from '../../../../domains/widgets/components/pivot-table-widget/types';
-import { TableWidgetProps } from '../../../../domains/widgets/components/table-widget/types';
 import { TextWidgetProps } from '../../../../domains/widgets/components/text-widget/types';
 import { WidgetDto } from '../../../../domains/widgets/components/widget-by-id/types.js';
 import { WidgetProps } from '../../../../domains/widgets/components/widget/types';
@@ -85,19 +84,6 @@ export declare function toPivotTableProps(widgetModel: WidgetModel): PivotTableP
  * Note: this method is not supported for pivot widgets.
  */
 export declare function toChartWidgetProps(widgetModel: WidgetModel): ChartWidgetProps;
-/**
- * Translates a {@link WidgetModel} to the props for rendering a table widget.
- *
- * @example
- * ```tsx
- * <TableWidget {...widgetModelTranslator.toTableWidgetProps(widgetModel)} />
- * ```
- *
- * Note: this method is not supported for chart widgets.
- * Use {@link toChartWidgetProps} instead for getting props for the <ChartWidget> component.
- * @internal
- */
-export declare function toTableWidgetProps(widgetModel: WidgetModel): TableWidgetProps;
 /**
    * Translates a {@link WidgetModel} to the props for rendering a pivot table widget.
    *
@@ -162,6 +148,14 @@ export declare function fromWidgetDto(widgetDto: WidgetDto, themeSettings?: Comp
  * @internal
  */
 export declare function fromChartWidgetProps(chartWidgetProps: ChartWidgetProps): WidgetModel;
+/**
+ * Creates a {@link WidgetModel} from a {@link PivotTableWidgetProps}.
+ *
+ * @param pivotTableWidgetProps - The PivotTableWidgetProps to be converted to a widget model
+ * @returns WidgetModel
+ * @internal
+ */
+export declare function fromPivotTableWidgetProps(pivotTableWidgetProps: PivotTableWidgetProps): WidgetModel;
 /**
  * Creates a {@link WidgetModel} from a {@link WidgetProps}.
  *

package/dist/packages/sdk-ui/src/infra/api/narrative/narrative-endpoints.d.ts

@@ -10,16 +10,16 @@ export declare const LEGACY_NARRATIVE_ENDPOINT = "api/v2/ai/nlg/queryResult";
  * @internal
  */
 export type GetNarrativeOptions = {
-    isUnifiedNarrationEnabled?: boolean;
+    isUnified?: boolean;
     isSisenseAiEnabled?: boolean;
 };
 /**
- * Fetches Narrative. Single place for endpoint logic: isUnifiedNarrationEnabled === false → legacy only;
+ * Fetches Narrative. Single place for endpoint logic: `isUnified === false` → legacy only;
  * otherwise try unified endpoint first, fall back to legacy on 404.
  *
  * @param httpClient - HttpClient instance
  * @param request - Narration request payload
- * @param options - Optional; isUnifiedNarrationEnabled (from props.isUnifiedNarrationEnabled)
+ * @param options - Optional; `isUnified` / `isSisenseAiEnabled` (e.g. from `app.settings.narrative`)
  * @returns Promise with narration response
  * @internal
  */

package/dist/packages/sdk-ui/src/infra/api/rest-api.d.ts

@@ -6,6 +6,17 @@ import { PaletteDto } from '../../infra/api/types/palette-dto';
 import { HierarchyDto, SharedFormulaDto, WidgetDto } from '../../domains/widgets/components/widget-by-id/types';
 import { TranslatableError } from '../translation/translatable-error';
 import type { DashboardDto } from './types/dashboard-dto';
+/** PATCH body for persisting Highcharts navigator scroller bounds on a dashboard widget. */
+export type WidgetDashboardScrollerLocationPatch = {
+    options: Partial<NonNullable<WidgetDto['options']>> & {
+        previousScrollerLocation: {
+            min: number;
+            max: number;
+        };
+    };
+};
+/** Supported PATCH bodies for `RestApi.patchWidgetInDashboard`. */
+export type PatchWidgetInDashboardBody = Partial<Pick<WidgetDto, 'title'>> | WidgetDashboardScrollerLocationPatch;
 type GetDashboardsOptions = {
     searchByTitle?: string;
     fields?: string[];
@@ -84,7 +95,7 @@ export declare class RestApi {
     /**
      * Partially update a widget in a dashboard.
      */
-    patchWidgetInDashboard: (dashboardOid: string, widgetOid: string, patch: Partial<Pick<WidgetDto, 'title'>>, sharedMode?: boolean) => Promise<WidgetDto | undefined>;
+    patchWidgetInDashboard: (dashboardOid: string, widgetOid: string, patch: PatchWidgetInDashboardBody, sharedMode?: boolean) => Promise<WidgetDto | undefined>;
     /**
      * Get shared formulas by ids
      *

package/dist/packages/sdk-ui/src/infra/app/settings/settings.d.ts

@@ -13,6 +13,7 @@ export type AppSettings = Required<ConfigurableAppSettings> & ServerSettings;
 type ConfigurableAppSettings = AppConfig;
 /**
  * User role permissions
+ *
  * @internal
  */
 type RoleManifest = {
@@ -63,14 +64,21 @@ type ServerSettings = {
     serverLanguage: string;
     serverVersion: string;
     serverFeatures: FeatureMap;
-    isUnifiedNarrationEnabled?: boolean;
-    isSisenseAiEnabled?: boolean;
+    narrative: {
+        /** From `api/v2/settings/ai` narration.enabled */
+        isEnabled: boolean;
+        /** From globals.props.narrationUnified */
+        isUnified: boolean;
+        /** Computed: unlimited (API sisenseAIEnabled or props) or credit-based narratives */
+        isSisenseAiEnabled: boolean;
+    };
     user: {
         tenant: {
             name: string;
         };
         /**
          * User role permissions
+         *
          * @internal
          */
         permissions: RoleManifest;

package/dist/packages/sdk-ui/src/infra/contexts/custom-widgets-provider/use-custom-widgets.d.ts

@@ -5,17 +5,22 @@ import { CustomWidgetComponent, CustomWidgetComponentProps } from './types';
  * @example
  * Example of registering a custom widget in a dashboard:
  * ```tsx
+ * import { useEffect } from 'react';
  * import { useCustomWidgets, DashboardById } from '@sisense/sdk-ui';
  * import CustomHistogramWidget from './custom-histogram-widget';
  *
  * const Example = () => {
- *   const { registerCustomWidget } = useCustomWidgets();
- *   registerCustomWidget('histogramwidget', CustomHistogramWidget);
+ *   const { registerCustomWidget, unregisterCustomWidget } = useCustomWidgets();
+ *
+ *   useEffect(() => {
+ *     registerCustomWidget('histogramwidget', CustomHistogramWidget);
+ *     // Optionally unregister on unmount (e.g. if the widget should only be available within this component)
+ *     return () => unregisterCustomWidget('histogramwidget');
+ *   }, [registerCustomWidget, unregisterCustomWidget]);
  *
  *   return <DashboardById dashboardOid="your-dashboard-oid" />;
  * }
  * ```
- *
  * @group Dashboards
  */
 export declare const useCustomWidgets: () => UseCustomWidgetsResult;
@@ -25,6 +30,8 @@ export declare const useCustomWidgets: () => UseCustomWidgetsResult;
 export type UseCustomWidgetsResult = {
     /** Registers a custom widget. */
     registerCustomWidget: <T = CustomWidgetComponentProps>(customWidgetType: string, customWidget: CustomWidgetComponent<T>) => void;
+    /** Unregisters a legacy custom widget for the given type name. */
+    unregisterCustomWidget: (customWidgetType: string) => void;
     /** Checks if a custom widget is registered. */
     hasCustomWidget: (customWidgetType: string) => boolean;
     /** Gets a custom widget. */

package/dist/packages/sdk-ui/src/infra/plugins/plugin-context.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-import { WidgetPlugin } from './widget-plugins/types.js';
+import type { AnyWidgetPlugin } from './widget-plugins/types.js';
 import type { WidgetPluginRegistry } from './widget-plugins/widget-plugin-registry.js';
 /**
  * Context for accessing registered plugins
@@ -10,7 +10,7 @@ export interface PluginContextValue {
     /**
      * Validated widget plugin declarations (metadata)
      */
-    widgetPlugins: readonly WidgetPlugin[];
+    widgetPlugins: readonly AnyWidgetPlugin[];
     /**
      * Central widget component registry (used for lookup and legacy bridge)
      */

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

@@ -1,4 +1,4 @@
-import type { WidgetPlugin } from './widget-plugins/types.js';
+import type { AnyWidgetPlugin } from './widget-plugins/types.js';
 /**
  * Base plugin information
  *
@@ -55,4 +55,4 @@ export interface PluginValidationResult {
  *
  * @sisenseInternal
  */
-export type Plugin = WidgetPlugin;
+export type Plugin = AnyWidgetPlugin;

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

@@ -131,6 +131,15 @@ export interface WidgetPlugin<Props = CustomVisualizationProps, StyleOptions = C
         };
     };
 }
+/**
+ * Any Widget plugin declaration
+ * Represents heterogeneous widget plugin declarations at registry/context boundaries.
+ * Generic params are intentionally erased because each plugin can define distinct props/style types.
+ * Do not consume component prop types from this alias directly.
+ *
+ * @sisenseInternal
+ */
+export type AnyWidgetPlugin = WidgetPlugin<any, any>;
 /**
  * Props passed to a user-defined custom visualization component.
  *