@sisense/sdk-ui 2.24.0 → 2.26.0

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

@@ -0,0 +1,16 @@
+import type { TFunction } from '@sisense/sdk-common';
+import type { BaseQueryParams } from '../../../../domains/query-execution/types';
+import type { QueryDefinitionViewModel } from './types';
+/**
+ * Builds the query definition view model from base query params.
+ * Order: Measures → "by" → Dimensions → "for"/"where" → Filters.
+ * 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)
+ * @sisenseInternal
+ */
+export declare function baseQueryParamsToViewModel(params: BaseQueryParams, t?: TFunction): QueryDefinitionViewModel;

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

@@ -0,0 +1,12 @@
+import { type FunctionComponent, type ReactNode } from 'react';
+export interface QueryPillBubbleTooltipProps {
+    children: ReactNode;
+    content: ReactNode;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** false = prefer above pill (default); true = prefer below (>3 lines of JSON). */
+    preferBelow?: boolean;
+    /** Tooltip stays inside this box (e.g. widget / story panel); intersects with viewport. */
+    boundaryElement?: HTMLElement | null;
+}
+export declare const QueryPillBubbleTooltip: FunctionComponent<QueryPillBubbleTooltipProps>;

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

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

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

@@ -0,0 +1,51 @@
+import { Attribute, Filter, FilterRelations, Measure } from '@sisense/sdk-data';
+/**
+ * Category of a query pill for styling (color).
+ *
+ * @sisenseInternal
+ */
+export type QueryPillCategory = 'measure' | 'dimension' | 'filter' | 'operator';
+/**
+ * A single pill item in the query definition (measure, dimension, filter, or operator).
+ *
+ * @sisenseInternal
+ */
+export interface QueryPillItem {
+    type: 'pill';
+    /** Display label (friendly name) */
+    label: string;
+    /** Category for pill color */
+    category: QueryPillCategory;
+    /** Optional stable id for keys */
+    id?: string;
+    /** Source entity for debug/tooltip JSON (measure, dimension attribute, filter, etc.) */
+    tooltipData?: Attribute | Measure | Filter | FilterRelations;
+}
+/**
+ * Connector between pill groups (plain text, no pill styling).
+ *
+ * @internal
+ */
+export interface ConnectorItem {
+    type: 'connector';
+    label: string;
+}
+/**
+ * View model for the QueryDefinition component: ordered list of pills and connectors.
+ * Order: Measures → "by" → Dimensions → "for"/"where" → Filters → Operators.
+ *
+ * @sisenseInternal
+ */
+export type QueryDefinitionViewModel = (QueryPillItem | ConnectorItem)[];
+/**
+ * Type guard for connector items.
+ *
+ * @internal
+ */
+export declare function isConnectorItem(item: QueryPillItem | ConnectorItem): item is ConnectorItem;
+/**
+ * Type guard for pill items.
+ *
+ * @internal
+ */
+export declare function isPillItem(item: QueryPillItem | ConnectorItem): item is QueryPillItem;

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

@@ -1,5 +1,7 @@
-import type { AreaStyleOptions, AxisLabel, DataLimits, LegendOptions, LineStyleOptions, LineWidth, Markers, Navigator, SeriesLabels } from '../../../../../types.js';
-import type { AxisStyle, CartesianWidgetStyle, WidgetSubtype } from '../types.js';
+import type { PivotGrandTotals } from '@sisense/sdk-data';
+import { AppSettings } from '../../../../../infra/app/settings/settings.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.
  *
@@ -51,6 +53,53 @@ export declare function toMarkersStyle(markers?: Markers): CartesianWidgetStyle[
  * @internal
  */
 export declare function toDataLimitsStyle(dataLimits?: DataLimits): CartesianWidgetStyle['dataLimits'];
+/**
+ * Returns true when {@link WidgetModel.styleOptions} carries any widget container / design
+ * field that was produced by {@link getFlattenWidgetDesign} (and should be written back).
+ *
+ * @internal
+ */
+export declare function hasWidgetContainerStyleFields(styleOptions: WidgetStyleOptions): boolean;
+/**
+ * Rebuilds Fusion `style.widgetDesign` from flattened container options (inverse of
+ * {@link getFlattenWidgetDesign}).
+ *
+ * Missing fields default to the corresponding values from `themeSettings.widget` so that
+ * the resulting {@link WidgetDesign} is always fully populated which is critical for the widget design feature in Fusion.
+ *
+ * @internal
+ */
+export declare function toWidgetDesign(styleOptions: WidgetStyleOptions, widgetTheme: CompleteThemeSettings['widget']): WidgetDesign | undefined;
+/**
+ * Attaches `style.widgetDesign` built from widget container fields in `styleOptions`.
+ * When the feature flag is off, or when `styleOptions` carries no container fields, the
+ * base style is returned unchanged.
+ *
+ * @param baseStyle - The base style to be attached with the widget design
+ * @param styleOptions - The style options to be used for the widget design
+ * @param themeSettings - The theme settings to be used for the widget design
+ * @param appSettings - The application settings to be used for the widget design
+ * @returns The widget style with the widget design
+ */
+export declare function withWidgetDesign(baseStyle: WidgetStyle, styleOptions: WidgetStyleOptions, themeSettings: CompleteThemeSettings, appSettings?: AppSettings): WidgetStyle;
+/**
+ * Maps SDK pie chart style options to Fusion PieWidgetStyle (DTO).
+ * Inverse of {@link extractPieChartStyleOptions}.
+ *
+ * @param styleOptions - Pie style options from WidgetModel.styleOptions
+ * @returns Fusion PieWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toPieWidgetStyle(styleOptions: PieStyleOptions): WidgetStyle;
+/**
+ * Maps SDK indicator style options to Fusion IndicatorWidgetStyle (DTO).
+ * Inverse of {@link extractIndicatorChartStyleOptions}.
+ *
+ * @param styleOptions - Indicator style options from WidgetModel.styleOptions
+ * @returns Fusion IndicatorWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toIndicatorWidgetStyle(styleOptions: IndicatorStyleOptions): WidgetStyle;
 /**
  * Maps SDK line chart style options to Fusion CartesianWidgetStyle (DTO).
  * Used when serializing a line chart widget back to WidgetDto.
@@ -69,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/utils.d.ts

@@ -0,0 +1,9 @@
+import { AppSettings } from '../../../../infra/app/settings/settings.js';
+/**
+ * Checks if widget design style is enabled.
+ * Pure function with default fallback.
+ *
+ * @param appSettings - Optional application settings
+ * @returns True if widget design is enabled
+ */
+export declare const isWidgetDesignEnabled: (appSettings?: AppSettings) => boolean;

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}.
  *
@@ -175,7 +169,10 @@ export declare function fromWidgetProps(widgetProps: WidgetProps): WidgetModel;
  *
  * @param widgetModel - The WidgetModel to be converted to a widgetDto
  * @param dataSource - The full datasource details
+ * @param themeSettings - The theme settings to be used for the widget design
+ * @param appSettings - The application settings to be used for the widget design
  * @returns WidgetDto
- * @internal
+ *
+ * @sisenseInternal
  */
-export declare function toWidgetDto(widgetModel: WidgetModel, dataSource?: JaqlDataSourceForDto): WidgetDto;
+export declare function toWidgetDto(widgetModel: WidgetModel, dataSource?: JaqlDataSourceForDto, themeSettings?: CompleteThemeSettings, appSettings?: AppSettings): WidgetDto;

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

@@ -0,0 +1,32 @@
+import type { JaqlQueryPayload } from '@sisense/sdk-query-client';
+export interface GetNlgInsightsRequest {
+    /**
+     * @privateRemarks
+     * JAQL sent with narrative requests. Chart narratives omit pivot-only fields; pivot narratives
+     * include full `JaqlQueryPayload` fields (`format`, `grandTotals`, `queryGuid`, etc.).
+     * The SDK sets the payload `by` field to `ComposeSDK` when calling the narrative API.
+     *
+     */
+    jaql: Partial<JaqlQueryPayload> & Pick<JaqlQueryPayload, 'datasource' | 'metadata'>;
+    verbosity?: 'Low' | 'High';
+}
+/** @internal */
+export type NarrativeRequest = GetNlgInsightsRequest;
+export interface NarrativeResponse {
+    data?: {
+        answer: string;
+    };
+    responseType: 'Text';
+}
+/**
+ * Payload for `api/v2/ai/feedback`.
+ *
+ * @internal
+ */
+export interface SendAiFeedbackRequest {
+    type: string;
+    data: object;
+    sourceId: string;
+    rating: -1 | 1;
+}
+export type GetNlgInsightsResponse = NarrativeResponse;

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

@@ -0,0 +1,6 @@
+/**
+ * Client origin tag for narrative AI requests (aligned with JAQL `by` for query execution).
+ *
+ * @internal
+ */
+export declare const NARRATIVE_BY_CSDK = "ComposeSDK";