@sisense/sdk-ui 2.25.0 → 2.27.0

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

@@ -32,7 +32,7 @@ export type CsdkPluginWidgetType = 'tabber-buttons';
 /**
  * The type of a widget on a dashboard.
  */
-export type FusionWidgetType = CartesianWidgetType | CategoricalWidgetType | 'chart/scatter' | 'indicator' | TabularWidgetType | 'chart/boxplot' | 'map/scatter' | 'map/area' | 'heatmap' | TextWidgetType | FusionPluginWidgetType | 'custom';
+export type FusionWidgetType = CartesianWidgetType | CategoricalWidgetType | 'chart/scatter' | 'indicator' | TabularWidgetType | 'chart/boxplot' | 'map/scatter' | 'map/area' | 'heatmap' | TextWidgetType | FusionPluginWidgetType | string;
 export type WidgetSubtype = 'area/basic' | 'area/stacked' | 'area/stacked100' | 'area/spline' | 'area/stackedspline' | 'area/stackedspline100' | 'bar/classic' | 'bar/stacked' | 'bar/stacked100' | 'column/classic' | 'column/stackedcolumn' | 'column/stackedcolumn100' | 'line/basic' | 'line/spline' | 'pie/classic' | 'pie/donut' | 'pie/ring' | 'column/polar' | 'area/polar' | 'line/polar' | 'indicator/numeric' | 'indicator/gauge' | 'bubble/scatter' | 'treemap' | 'sunburst' | 'boxplot/full' | 'boxplot/hollow' | 'map/scatter' | 'areamap/world' | 'areamap/usa' | 'richtexteditor';
 export declare enum WidgetDashboardFilterMode {
     FILTER = "filter",
@@ -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
  *
@@ -18,7 +27,7 @@ export { mergeFilters, getFilterRelationsFromJaql, convertFilterRelationsModelTo
  */
 export declare function getChartType(fusionWidgetType: FusionWidgetType): ChartType | undefined;
 export declare function getFusionWidgetTypeFromChartType(chartType: ChartType): FusionWidgetType;
-export declare function getFusionWidgetType(widgetType: WidgetType, chartType?: ChartType): FusionWidgetType;
+export declare function getFusionWidgetType(widgetType: WidgetType, chartType?: ChartType, customWidgetType?: string): FusionWidgetType;
 export declare function getWidgetType(fusionWidgetType: FusionWidgetType): WidgetType;
 export declare function getChartSubtype(widgetSubtype: WidgetSubtype): ChartSubtype | undefined;
 export declare function isSupportedWidgetType(fusionWidgetType: string): fusionWidgetType is FusionWidgetType;

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,183 @@
+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 type { GenericDataOptions } from '../../../../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[];
+/**
+ * Builds DTO panels for a plugin / custom widget. Each key in {@link GenericDataOptions}
+ * becomes one panel; every Column is normalised then converted to a JAQL panel item via
+ * the same helper chart widgets use, so the DTO round-trips through `fromWidgetDto`
+ * without further translation. The `filters` key is reserved by the DTO schema and
+ * emitted separately from `widgetModel.filters`, so it is skipped here.
+ *
+ * @param dataOptions - Generic data options keyed by the plugin's input names
+ * @returns One Fusion panel per declared input
+ * @internal
+ */
+export declare function toCustomWidgetPanels(dataOptions: GenericDataOptions | undefined): Panel[];

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

@@ -1,10 +1,10 @@
 import { JaqlDataSourceForDto } from '@sisense/sdk-data';
+import type { JumpToDashboardConfig, JumpToDashboardConfigForPivot } from '../../../../domains/dashboarding/hooks/jtd/jtd-types.js';
 import { ExecutePivotQueryParams, ExecuteQueryParams } from '../../../../domains/query-execution/index.js';
 import { ChartWidgetProps } from '../../../../domains/widgets/components/chart-widget/types';
 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 +85,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.
    *
@@ -144,6 +131,26 @@ export declare function toCommonWidgetProps(widgetModel: WidgetModel): CommonWid
  * ```
  */
 export declare function toWidgetProps(widgetModel: WidgetModel): WidgetProps;
+/**
+ * Returns Jump to Dashboard configuration for a {@link WidgetModel} that was built from
+ * Fusion via {@link fromWidgetDto}.
+ *
+ * @param widgetModel - The {@link WidgetModel} built from Fusion via {@link fromWidgetDto};
+ *
+ * @returns `JumpToDashboardConfig`, `JumpToDashboardConfigForPivot`, or `null` when the model is not
+ * Fusion-sourced, or the widget has no versioned JTD.
+ *
+ * @example
+ * ```tsx
+ * const widgetProps = widgetModelTranslator.toWidgetProps(widgetModel);
+ * const jtdConfig = widgetModelTranslator.toJtdConfig(widgetModel);
+ * // When jtdConfig is non-null, pass widgetProps and jtdConfig to useJtdWidget; otherwise render the widget with widgetProps alone.
+ * ```
+ *
+ * @sisenseInternal
+ * @alpha
+ */
+export declare function toJtdConfig(widgetModel: WidgetModel): JumpToDashboardConfig | JumpToDashboardConfigForPivot | null;
 /**
  * Creates a {@link WidgetModel} from a widget DTO.
  *
@@ -162,6 +169,30 @@ 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 TextWidgetProps}.
+ *
+ * @param textWidgetProps - The TextWidgetProps to be converted to a widget model
+ * @returns WidgetModel
+ * @internal
+ */
+export declare function fromTextWidgetProps(textWidgetProps: TextWidgetProps): WidgetModel;
+/**
+ * Creates a {@link WidgetModel} from a {@link CustomWidgetProps}.
+ *
+ * @param customWidgetProps - The CustomWidgetProps to be converted to a widget model
+ * @returns WidgetModel
+ * @internal
+ */
+export declare function fromCustomWidgetProps(customWidgetProps: CustomWidgetProps): WidgetModel;
 /**
  * Creates a {@link WidgetModel} from a {@link WidgetProps}.
  *

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

@@ -1,5 +1,6 @@
 import { DataSource, Filter } from '@sisense/sdk-data';
 import { EmptyObject } from '@sisense/sdk-query-client/src/helpers/utility-types';
+import type { JumpToDashboardConfig, JumpToDashboardConfigForPivot } from '../../../domains/dashboarding/hooks/jtd/jtd-types';
 import { ChartDataOptions, PivotTableDataOptions } from '../../../domains/visualizations/core/chart-data-options/types';
 import { ChartType, DrilldownOptions, PivotTableDrilldownOptions, WidgetStyleOptions } from '../../../types';
 import type { WidgetType } from '../components/widget/types';
@@ -70,5 +71,16 @@ export interface WidgetModel {
      * Widget drilldown options.
      */
     drilldownOptions: DrilldownOptions | PivotTableDrilldownOptions;
+    /**
+     * Jump to Dashboard configuration for this widget, when the model was built from a Fusion
+     * `WidgetDto` via `fromWidgetDto`. Populated with the same translation as dashboard
+     * `fromDashboardDto` uses for `widgetsOptions` (via `translateWidgetsOptions` →
+     * `jumpToDashboardConfigFromWidgetDto`). Omitted or `undefined` when the model is not
+     * Fusion-sourced (e.g. from widget props) or the widget has no versioned JTD.
+     *
+     * @see {@link widgetModelTranslator.toJtdConfig}
+     * @internal
+     */
+    jtdConfig?: JumpToDashboardConfig | JumpToDashboardConfigForPivot;
 }
 export declare const isWidgetModel: (widget: any) => widget is WidgetModel;

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

@@ -10,17 +10,23 @@ export declare const LEGACY_NARRATIVE_ENDPOINT = "api/v2/ai/nlg/queryResult";
  * @internal
  */
 export type GetNarrativeOptions = {
-    isUnifiedNarrationEnabled?: boolean;
-    isSisenseAiEnabled?: boolean;
+    canGenerateNarrativeViaAI?: boolean;
+    /**
+     * When provided and the primary request returns a 400, the request is retried once with this
+     * fallback payload. Intended for trend/forecast stripping when the backend cannot handle them.
+     */
+    fallbackRequestOn400?: NarrativeRequest;
 };
 /**
- * Fetches Narrative. Single place for endpoint logic: isUnifiedNarrationEnabled === false → legacy only;
- * otherwise try unified endpoint first, fall back to legacy on 404.
+ * Fetches Narrative. Single place for endpoint logic: when `canGenerateNarrativeViaAI` is truthy,
+ * try the unified endpoint first and fall back to legacy on 404; otherwise hit legacy directly.
+ * When `fallbackRequestOn400` is provided and the primary request returns a 400, the request is
+ * retried once with the fallback payload.
  *
  * @param httpClient - HttpClient instance
  * @param request - Narration request payload
- * @param options - Optional; isUnifiedNarrationEnabled (from props.isUnifiedNarrationEnabled)
- * @returns Promise with narration response
+ * @param options - Optional; `canGenerateNarrativeViaAI` (typically from `app.settings.narrative`)
+ * @returns Promise that resolves with narration JSON or `undefined` (same semantics as `HttpClient.post`)
  * @internal
  */
-export declare function getNarrative(httpClient: HttpClient, request: NarrativeRequest, options?: GetNarrativeOptions): Promise<NarrativeResponse>;
+export declare function getNarrative(httpClient: HttpClient, request: NarrativeRequest, options?: GetNarrativeOptions): Promise<NarrativeResponse | undefined>;

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
      *