@sisense/sdk-ui 2.28.0 → 2.30.0

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

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

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

@@ -1,6 +1,6 @@
 import type { WidgetHeaderConfig } from '../../../../domains/widgets/shared/widget-header/types.js';
 import type { CustomWidgetProps } from './types.js';
-export type UseCustomWidgetExcelDownloadParams = Pick<CustomWidgetProps, 'title' | 'dataOptions' | 'filters' | 'highlights' | 'config' | 'dataSource' | 'customWidgetType' | 'id'> & {
+export type UseCustomWidgetExcelDownloadParams = Pick<CustomWidgetProps, 'title' | 'dataOptions' | 'filters' | 'config' | 'dataSource' | 'customWidgetType' | 'id'> & {
     baseHeaderConfig: WidgetHeaderConfig;
 };
 export type UseCustomWidgetExcelDownloadResult = {

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

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

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

@@ -4,7 +4,7 @@ import type { CustomDataCellFormatter, CustomHeaderCellFormatter } from '../../.
 import { PivotTableDataOptions } from '../../../../domains/visualizations/core/chart-data-options/types';
 import type { PivotTableWidgetChangeEvent, PivotTableWidgetDrilldownSelectionsChangedEvent } from '../../../../domains/widgets/change-events';
 import type { PivotTableDataPointEventHandler } from '../../../../props';
-import { PivotTableDrilldownOptions, PivotTableWidgetStyleOptions } from '../../../../types';
+import { PivotTableDrilldownOptions, PivotTableWidgetStyleOptions, WidgetAiOptions } from '../../../../types';
 import { WidgetConfig } from '../widget/types';
 export type { PivotTableWidgetChangeEvent, PivotTableWidgetDrilldownSelectionsChangedEvent };
 /**
@@ -43,6 +43,12 @@ export interface PivotTableWidgetProps {
      * @category Widget
      */
     styleOptions?: PivotTableWidgetStyleOptions;
+    /**
+     * Configuration for AI-powered widget features such as automated narrative generation
+     * @alpha
+     * @category Widget
+     */
+    aiOptions?: WidgetAiOptions;
     /**
      * Widget configuration (e.g. header toolbar menu)
      *

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

@@ -1,6 +1,6 @@
 import type { WidgetHeaderConfig } from '../../../../domains/widgets/shared/widget-header/types.js';
 import type { PivotTableWidgetProps } from './types.js';
-export type UsePivotWidgetExcelDownloadParams = Pick<PivotTableWidgetProps, 'title' | 'dataOptions' | 'config' | 'dataSource' | 'filters' | 'highlights' | 'id'> & {
+export type UsePivotWidgetExcelDownloadParams = Pick<PivotTableWidgetProps, 'title' | 'dataOptions' | 'config' | 'dataSource' | 'filters' | 'id'> & {
     baseHeaderConfig: WidgetHeaderConfig;
 };
 export type UsePivotWidgetExcelDownloadResult = {

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

@@ -2,3 +2,4 @@ export * from './apply-partial-dto-style.js';
 export * from './extract-unsupported-style-options.js';
 export * from './translate-widget-style-options.js';
 export * from './to-widget-dto-style.js';
+export * from './widget-narrative-style.js';

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

@@ -1,4 +1,4 @@
-import { TabberButtonsWidgetStyleOptions } from '../../../../../types.js';
+import { TabberButtonsWidgetCustomOptions, TabberButtonsWidgetStyleOptions } from '../../../../../types.js';
 import { TabberWidgetDto, TabberWidgetDtoStyle } from '../types.js';
 /**
  * Extracts style options from TabberWidgetDtoStyle.
@@ -21,3 +21,19 @@ export declare function extractTabberButtonsWidgetCustomOptions(tabberDto: Tabbe
     tabNames: string[];
     activeTab: number;
 };
+/**
+ * Builds the tabber DTO style from CSDK tabber style and custom options.
+ * Inverse of {@link extractTabberButtonsWidgetStyleOptions} and
+ * {@link extractTabberButtonsWidgetCustomOptions}: re-encodes the lowercase enum
+ * values back to uppercase, reconstructs the `useSelectedBkg`/`useUnselectedBkg`
+ * flags from the presence of the corresponding background colors, and
+ * re-materializes `tabs`/`activeTab` from the custom options.
+ *
+ * Note: `displayWidgetIds`/`hideWidgetIds` are not represented in the CSDK
+ * widget model, so the re-materialized tabs carry empty id lists.
+ *
+ * @param styleOptions - The tabber style options from WidgetModel.styleOptions
+ * @param customOptions - The tabber custom options from WidgetModel.customOptions
+ * @returns The tabber widget style for the DTO
+ */
+export declare function toTabberWidgetStyle(styleOptions: TabberButtonsWidgetStyleOptions, customOptions: TabberButtonsWidgetCustomOptions): TabberWidgetDtoStyle;

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

@@ -1,7 +1,8 @@
 import type { PivotGrandTotals } from '@sisense/sdk-data';
+import type { BoxWhiskerType } from '../../../../../domains/visualizations/core/chart-data-options/types.js';
 import { AppSettings } from '../../../../../infra/app/settings/settings.js';
-import type { AreamapType, AreaStyleOptions, AxisLabel, CompleteThemeSettingsInternal, 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';
+import type { AreamapType, AreaStyleOptions, AxisLabel, BoxplotStyleOptions, CalendarHeatmapStyleOptions, CompleteThemeSettingsInternal, 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, BoxplotWidgetStyle, CalendarHeatmapWidgetStyle, CartesianWidgetStyle, FunnelWidgetStyle, PivotWidgetStyle, PolarWidgetStyle, ScattermapWidgetStyle, ScatterWidgetStyle, SunburstWidgetStyle, TableWidgetStyle, TreemapWidgetStyle, WidgetDesign, WidgetStyle, WidgetSubtype } from '../types.js';
 /**
  * Maps SDK legend options to Fusion DTO legend style.
  *
@@ -211,6 +212,44 @@ export declare function toScattermapWidgetStyle(styleOptions: ScattermapStyleOpt
  * @internal
  */
 export declare function toAreamapSubtype(mapType?: AreamapType): 'areamap/world' | 'areamap/usa';
+/**
+ * Converts boxplot style options to Fusion BoxplotWidgetStyle DTO.
+ * Inverse of `extractBoxplotChartStyleOptions`.
+ *
+ * The whisker algorithm (`boxType`) and `outliersEnabled` flag live on
+ * {@link BoxplotChartDataOptions} in the WidgetModel rather than on `styleOptions`,
+ * so they are passed in separately. `boxType` defaults to `'iqr'` — the same default
+ * the boxplot translator falls back to when no whisker flag is selected.
+ *
+ * @param styleOptions - Boxplot style options from WidgetModel.styleOptions
+ * @param boxType - Whisker algorithm from WidgetModel.dataOptions.boxType
+ * @param outliersEnabled - Whether to render boxplot outliers
+ * @returns Fusion BoxplotWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toBoxplotWidgetStyle(styleOptions: BoxplotStyleOptions, boxType?: BoxWhiskerType, outliersEnabled?: boolean): BoxplotWidgetStyle;
+/**
+ * Converts calendar-heatmap style options to Fusion CalendarHeatmapWidgetStyle DTO.
+ * Inverse of {@link extractCalendarHeatmapChartStyleOptions}.
+ *
+ * Only the fields the inverse extractor reads are round-trippable. Cosmetic fields
+ * that the extractor synthesizes from {@link CALENDAR_HEATMAP_DEFAULTS}
+ * (`monthLabels.enabled`, `weekends.cellColor`, `weekends.hideValues`,
+ * `pagination.enabled`) are not written back because the Fusion DTO has no fields
+ * for them.
+ *
+ * The CSDK `subtype` (`'calendar-heatmap/split' | 'calendar-heatmap/continuous'`)
+ * is NOT the DTO `subtype` — the DTO uses `'heatmap'` and encodes view as the
+ * `'view/weekly'` / `'view/monthly'` style flags.
+ *
+ * `pagination.startMonth` is emitted as `{year, month}` because Fusion's startMonth
+ * object form is the canonical write shape; the string form is read-only legacy input.
+ *
+ * @param styleOptions - Calendar heatmap style options from WidgetModel.styleOptions
+ * @returns Fusion CalendarHeatmapWidgetStyle for the widget DTO
+ * @internal
+ */
+export declare function toCalendarHeatmapWidgetStyle(styleOptions: CalendarHeatmapStyleOptions): CalendarHeatmapWidgetStyle;
 /**
  * Converts table style options to Fusion TableWidgetStyle DTO.
  * Used when serializing a table widget back to WidgetDto.

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

@@ -0,0 +1,31 @@
+import type { WidgetDtoNarration, WidgetStyle } from '../../../../../domains/widgets/components/widget-by-id/types.js';
+import type { WidgetNarrativeOptions } from '../../../../../types.js';
+/**
+ * Maps Fusion `style.narration` into SDK {@link WidgetNarrativeOptions},
+ * including `feedback` when present on the DTO.
+ *
+ * Reads boolean `autoShow`; legacy string `displayMode` (`onLoad` / `onClick`) is still accepted for
+ * older payloads when `autoShow` is absent.
+ *
+ * @param dto - Fusion narration payload, if any
+ * @returns Partial narrative options, or `undefined` when absent or empty
+ * @internal
+ */
+export declare function extractWidgetNarrativeOptionsFromDto(dto: WidgetDtoNarration | undefined): WidgetNarrativeOptions | undefined;
+/**
+ * Builds Fusion `style.narration` from SDK {@link WidgetNarrativeOptions} only (typed fields).
+ *
+ * @param narrative - SDK narrative slice from {@link WidgetAiOptions.narrative}
+ * @returns Narration DTO, or `undefined` when nothing should be written
+ * @internal
+ */
+export declare function narrativeOptionsToWidgetDtoNarration(narrative: WidgetNarrativeOptions | undefined): WidgetDtoNarration | undefined;
+/**
+ * Merges narrative options onto a Fusion widget `style` object for {@link toWidgetDto}.
+ *
+ * @param baseStyle - Chart or pivot style object without narration
+ * @param narrative - SDK narrative from {@link WidgetModel.aiOptions}
+ * @returns `WidgetStyle` with narration merged, or base style unchanged when narrative is absent
+ * @internal
+ */
+export declare function mergeWidgetStyleWithNarrativeForDto(baseStyle: WidgetStyle, narrative: WidgetNarrativeOptions | undefined): WidgetStyle;

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

@@ -77,6 +77,12 @@ export interface WidgetDto {
         supportsHierarchies?: boolean;
         imageColumns?: number[];
     };
+    /**
+     * Custom-widget-specific runtime options bag, persisted across reloads for
+     * custom (plugin) widgets. Round-trips opaquely between the Fusion DTO and the
+     * CSDK widget model's `customOptions`.
+     */
+    customOptions?: Record<string, unknown>;
     source?: any;
     owner?: string;
     userId?: string;
@@ -562,9 +568,38 @@ export type CalendarHeatmapWidgetStyle = {
         month: number;
     };
 };
+/**
+ * Fusion `style.narration` payload (chart widgets and others that support narration).
+ *
+ * @internal
+ */
+export type WidgetDtoNarration = {
+    enabled?: boolean;
+    /** Placement string from Fusion; maps to SDK `displayLocation`. */
+    display?: string;
+    format?: string;
+    verbosity?: string;
+    up_sentiment?: string;
+    aggregation?: string;
+    labels?: readonly {
+        id: string;
+        title: string;
+        singular: string;
+        plural: string;
+    }[];
+    includeTrendAndForecast?: boolean;
+    /** When `true`, narrative is shown as soon as the widget loads */
+    autoShow?: boolean;
+    /** Narrative feedback actions */
+    feedback?: {
+        enabled?: boolean;
+    };
+    /** Fraction (0–1) of the content area height reserved for the narrative; maps to SDK `height`. */
+    size?: number;
+};
 export type WidgetStyle = {
     widgetDesign?: WidgetDesign;
-    narration?: any;
+    narration?: WidgetDtoNarration;
 } & (CartesianWidgetStyle | PolarWidgetStyle | FunnelWidgetStyle | PieWidgetStyle | ScatterWidgetStyle | TableWidgetStyle | IndicatorWidgetStyle | TreemapWidgetStyle | SunburstWidgetStyle | BoxplotWidgetStyle | ScattermapWidgetStyle | AreamapWidgetStyle | PivotWidgetStyle | CalendarHeatmapWidgetStyle | TextWidgetDtoStyle | TabberWidgetDtoStyle);
 export declare enum FiltersMergeStrategyEnum {
     WIDGET_FIRST = "widgetFirst",

package/dist/packages/sdk-ui/src/domains/widgets/helpers/excel-export-map-dimensions-measures.d.ts

@@ -1,4 +1,10 @@
-import { type Attribute, type Measure } from '@sisense/sdk-data';
+import { type Attribute, type CalculatedMeasureColumn, type Measure, type MeasureColumn } from '@sisense/sdk-data';
+import type { StyledMeasureColumn } from '../../../domains/visualizations/core/chart-data-options/types.js';
+import type { NumberFormatConfig } from '../../../types';
+export type MeasureWithExcelExportFormat = Measure & {
+    readonly excelNumberFormatConfig?: NumberFormatConfig;
+};
+type MeasureColumnInput = MeasureColumn | CalculatedMeasureColumn | StyledMeasureColumn;
 /**
  * Returns attributes prepared for Excel JAQL export: dimensional level attributes without an
  * explicit display format receive a level-appropriate default so the backend renders human-readable
@@ -15,4 +21,13 @@ export declare function mapAttributesForExcelExport(attributes: readonly Attribu
  * @param measures - Raw measures from chart or pivot translation
  * @returns New array of measures safe to pass as export measures
  */
-export declare function mapMeasuresForExcelExport(measures: readonly Measure[]): Measure[];
+export declare function mapMeasuresForExcelExport(measures: readonly Measure[]): MeasureWithExcelExportFormat[];
+/**
+ * Maps a styled measure column to a measure for Excel export, preserving `numberFormatConfig`.
+ */
+export declare function mapMeasureColumnForExcelExport(column: MeasureColumnInput): MeasureWithExcelExportFormat;
+/**
+ * Maps measure columns to measures for Excel export, preserving per-column `numberFormatConfig`.
+ */
+export declare function mapMeasureColumnsForExcelExport(columns: readonly MeasureColumnInput[]): MeasureWithExcelExportFormat[];
+export {};

package/dist/packages/sdk-ui/src/domains/widgets/helpers/number-format-config-to-numeric-mask.d.ts

@@ -0,0 +1,5 @@
+import type { NumberFormatConfig } from '../../../types';
+/**
+ * Converts Compose {@link NumberFormatConfig} to a Fusion numeric mask for XLSX export metadata.
+ */
+export declare function numberFormatConfigToNumericMask(config: NumberFormatConfig): Record<string, unknown>;

package/dist/packages/sdk-ui/src/domains/widgets/hooks/use-track-widget-init.d.ts

@@ -0,0 +1,44 @@
+import type { WidgetType } from '../components/widget/types';
+/**
+ * Fully resolved options for {@link useTrackWidgetInit}. The caller (a leaf widget) is
+ * responsible for deriving each field from its own props so the hook stays free of
+ * widget-shape concerns and runtime type casts.
+ *
+ * @internal
+ */
+export type UseTrackWidgetInitOptions = {
+    /** Widget type (chart / pivot / text / custom). */
+    widgetType: WidgetType;
+    /** Resolved widget kind — chart subtype, plugin name, or fixed string for pivot/text. */
+    widgetName: string;
+    /** Widget title entered by the designer, or `null` if absent. */
+    widgetTitle: string | null;
+    /** Stable unique widget identifier — the widget id/OID when available, otherwise a content hash. */
+    entityId: string;
+    /**
+     * When `false`, the event is suppressed. Pass the caller's render preconditions here
+     * (e.g. `!!(chartType && dataOptions)` for `ChartWidget`) so we do not count mounts
+     * whose render body early-returns `null`. The event fires once when this flips to `true`.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+};
+/**
+ * Fires the `sdkWidgetInit` tracking event exactly once per widget mount.
+ *
+ * Behavioral note: unlike `useTrackComponentInit`, this hook intentionally
+ * IGNORES `TrackingContextProvider`'s skip-nested signal. Widgets rendered inside
+ * a tracked parent (e.g. a `<Dashboard>`) must still emit `sdkWidgetInit`, since
+ * the event must count every widget render regardless of nesting.
+ *
+ * The payload includes envelope overrides (`eventType: 'action'`,
+ * `featureName: 'composesdk'`, `entityType: 'widget'`) that override the defaults
+ * set by `trackProductEvent`, as required by the data-tracking spec.
+ *
+ * `widgetTitle` is emitted as `null` rather than `undefined` when absent, matching the
+ * spec's "null or [empty]" wire convention.
+ *
+ * @internal
+ */
+export declare const useTrackWidgetInit: (options: UseTrackWidgetInitOptions) => void;

package/dist/packages/sdk-ui/src/domains/widgets/hooks/widget-entity-id.d.ts

@@ -0,0 +1,30 @@
+import { type DataSource } from '@sisense/sdk-data';
+import type { ChartDataOptions, PivotTableDataOptions } from '../../../domains/visualizations/core/chart-data-options/types';
+import type { GenericDataOptions } from '../../../types';
+import type { WidgetType } from '../components/widget/types';
+/** Union of every widget's `dataOptions` shape (chart, pivot, custom). */
+type WidgetDataOptions = ChartDataOptions | PivotTableDataOptions | GenericDataOptions;
+/**
+ * Resolves a stable, unique `entityId` for a widget tracking event.
+ *
+ * Prefers the widget's own `id` (the Fusion widget OID when loaded via `WidgetById` /
+ * `DashboardById`, or the user-supplied id when composed). When no id is available — e.g. a
+ * standalone `<ChartWidget>` — it falls back to a deterministic hash of the widget's identity:
+ * its type, name, title, the column names of its `dataOptions`, and its data source. Two
+ * structurally identical standalone widgets therefore resolve to the same id, which is the
+ * desired behavior for adoption tracking. The fallback is prefixed with `hash:` so downstream
+ * consumers can tell a generated identifier apart from a real widget id/OID.
+ *
+ * Typed with a generic + intersection so callers pass their concrete widget prop type while the
+ * optional `id` / `dataOptions` / `dataSource` are read uniformly (e.g. `TextWidgetProps` declares
+ * none of them).
+ *
+ * @internal
+ */
+export declare const getWidgetEntityId: <P extends object>(props: P & {
+    id?: string | undefined;
+    title?: string | undefined;
+    dataOptions?: WidgetDataOptions | undefined;
+    dataSource?: DataSource | undefined;
+}, widgetType: WidgetType, widgetName: string) => string;
+export {};

package/dist/packages/sdk-ui/src/domains/widgets/hooks/widget-tracking-adapters.d.ts

@@ -0,0 +1,41 @@
+import type { ChartWidgetProps } from '../../../domains/widgets/components/chart-widget/types';
+import type { CustomWidgetProps } from '../../../domains/widgets/components/custom-widget/types';
+/**
+ * Resolves the `widgetName` tracking field for a chart widget — the visualization subtype
+ * (e.g. `'line'`, `'column'`, `'pie'`, `'streamgraph'`).
+ *
+ * @internal
+ */
+export declare const getChartWidgetName: (props: Pick<ChartWidgetProps, 'chartType'>) => string;
+/**
+ * Resolves the `widgetName` tracking field for a pivot table widget.
+ *
+ * @internal
+ */
+export declare const getPivotWidgetName: () => string;
+/**
+ * Resolves the `widgetName` tracking field for a text widget.
+ *
+ * @internal
+ */
+export declare const getTextWidgetName: () => string;
+/**
+ * Resolves the `widgetName` tracking field for a custom widget — the registered plugin name
+ * (e.g. `'my-org-bullet-chart'`).
+ *
+ * @internal
+ */
+export declare const getCustomWidgetName: (props: Pick<CustomWidgetProps, 'customWidgetType'>) => string;
+/**
+ * Reads the widget's user-facing title from props if present, otherwise `null`.
+ *
+ * Typed with a generic + intersection so callers preserve their concrete widget prop type
+ * (`ChartWidgetProps`, `PivotTableWidgetProps`, …) while making the contract — "I read an
+ * optional `title`" — explicit. The intersection sidesteps the weak-type heuristic that
+ * would otherwise reject `TextWidgetProps`, which declares no `title`.
+ *
+ * @internal
+ */
+export declare const getWidgetTitle: <P extends object>(props: P & {
+    title?: string | undefined;
+}) => string | null;

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

@@ -1,4 +1,4 @@
-import { type ReactNode } from 'react';
+import { type ReactNode, type RefObject } from 'react';
 import { WidgetContainerStyleOptions } from '../../../../types';
 import { TitleEditorConfig, WidgetHeaderConfig } from '../widget-header/types.js';
 export interface WidgetContainerProps {
@@ -16,6 +16,12 @@ export interface WidgetContainerProps {
     bottomSlot?: ReactNode;
     children: ReactNode;
     onRefresh?: () => void;
+    /**
+     * Ref attached to the content area below the header (topSlot + chart + bottomSlot).
+     * Use to measure the available height for narrative-to-chart ratio calculations.
+     * @internal
+     */
+    contentAreaRef?: RefObject<HTMLDivElement | null>;
 }
 /** @internal */
 export declare const WidgetContainer: React.FC<WidgetContainerProps>;

package/dist/packages/sdk-ui/src/domains/widgets/shared/widget-style-utils.d.ts

@@ -12,3 +12,32 @@ export declare enum WidgetSpaceAround {
     'Small' = "5px"
 }
 export declare const getShadowValue: (styleOptions: WidgetContainerStyleOptions | undefined, themeSettings: CompleteThemeSettingsInternal) => string;
+/**
+ * Resolves the effective "space around" value, in pixels, that the widget container applies
+ * as padding on each side. Reads from the widget's style options first, then falls back to
+ * the theme's widget settings.
+ *
+ * @param styleOptions - The widget container style options.
+ * @param themeSettings - The complete theme settings.
+ * @returns The space around value in pixels (0 when unset or "None").
+ * @internal
+ */
+export declare const getSpaceAroundPx: (styleOptions: WidgetContainerStyleOptions | undefined, themeSettings: CompleteThemeSettingsInternal) => number;
+/**
+ * Calculates the total non-content vertical space, in pixels, that the widget container reserves —
+ * the header (when visible) plus the top and bottom "space around" padding.
+ *
+ * Auto-sized widget content must add this overhead to its measured content height so that the
+ * visible content area (after the container subtracts its padding and header) matches the
+ * content's intended height. Without it, the bottom of the content is clipped by the container's
+ * `overflow: hidden`.
+ *
+ * @param options - The overhead height options.
+ * @returns The total overhead height in pixels.
+ * @internal
+ */
+export declare const getWidgetOverheadHeight: ({ styleOptions, themeSettings, hasHeader, }: {
+    styleOptions: WidgetContainerStyleOptions | undefined;
+    themeSettings: CompleteThemeSettingsInternal;
+    hasHeader: boolean;
+}) => number;

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

@@ -1,4 +1,4 @@
-import { AreamapChartDataOptions, CartesianChartDataOptions, CategoricalChartDataOptions, IndicatorChartDataOptions, PivotTableDataOptions, ScatterChartDataOptions, ScattermapChartDataOptions, TableDataOptionsInternal } from '../../../../domains/visualizations/core/chart-data-options/types.js';
+import { AreamapChartDataOptions, BoxplotChartDataOptions, CalendarHeatmapChartDataOptions, 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';
@@ -169,6 +169,34 @@ export declare function toScattermapPanels(dataOptions: ScattermapChartDataOptio
  * @internal
  */
 export declare function toAreamapPanels(dataOptions: AreamapChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a boxplot chart widget. Emits `category` (0 or 1 attribute)
+ * and `value` (the single target numeric attribute, treated as an attribute — not a
+ * measure — to match the inverse read in `extractBoxplotChartDataOptions`). The
+ * derived box/whisker measures live on `style.whisker` rather than on panels, so
+ * they are written by {@link toBoxplotWidgetStyle} instead.
+ *
+ * @param dataOptions - Boxplot chart data options from the WidgetModel
+ * @returns Fusion panels in fixed order: category, value
+ * @internal
+ */
+export declare function toBoxplotPanels(dataOptions: BoxplotChartDataOptions): Panel[];
+/**
+ * Builds DTO panels for a calendar-heatmap widget. The Fusion `heatmap` manifest declares
+ * `date` (single attribute) and `color` (single measure) panels — both are always emitted,
+ * matching the inverse read in {@link extractCaledarHeatmapChartDataOptions}: an empty
+ * `items: []` array is written when a slot has no column so Fusion's renderer can locate
+ * each declared panel by name.
+ *
+ * Note: the DTO panel name for the measure slot is `color`, not `value` — the SDK's
+ * {@link CalendarHeatmapChartDataOptions.value} is read from / written to the panel named
+ * `color`.
+ *
+ * @param dataOptions - Calendar heatmap chart data options from the WidgetModel
+ * @returns Fusion panels: date, color
+ * @internal
+ */
+export declare function toCalendarHeatmapPanels(dataOptions: CalendarHeatmapChartDataOptions): 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

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

@@ -2,7 +2,7 @@ import { DataSource, Filter } from '@sisense/sdk-data';
 import { EmptyObject } from '@sisense/sdk-query-client/src/helpers/utility-types';
 import 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 { ChartType, DrilldownOptions, PivotTableDrilldownOptions, WidgetAiOptions, WidgetStyleOptions } from '../../../types';
 import type { WidgetType } from '../components/widget/types';
 /**
  * Widget data options.
@@ -49,6 +49,11 @@ export interface WidgetModel {
      * Widget style options.
      */
     styleOptions: WidgetStyleOptions;
+    /**
+     * Configuration for AI-powered widget features such as automated narrative generation
+     * @alpha
+     */
+    aiOptions?: WidgetAiOptions;
     /**
      * Custom widget options. Only present for custom widgets.
      *

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

@@ -24,9 +24,9 @@ export type GetNarrativeOptions = {
  * retried once with the fallback payload.
  *
  * @param httpClient - HttpClient instance
- * @param request - Narration request payload
+ * @param request - Narrative request payload
  * @param options - Optional; `canGenerateNarrativeViaAI` (typically from `app.settings.narrative`)
- * @returns Promise that resolves with narration JSON or `undefined` (same semantics as `HttpClient.post`)
+ * @returns Promise that resolves with narrative JSON or `undefined` (same semantics as `HttpClient.post`)
  * @internal
  */
 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

@@ -25,6 +25,7 @@ type GetDashboardsOptions = {
 type GetDashboardOptions = {
     fields?: string[];
     sharedMode?: boolean;
+    adminAccess?: boolean;
 };
 export declare class RestApi {
     private httpClient;
@@ -55,7 +56,7 @@ export declare class RestApi {
     /**
      * Get a specific dashboard using the legacy API version
      */
-    getDashboardLegacy: (dashboardOid: string) => Promise<DashboardDto | undefined>;
+    getDashboardLegacy: (dashboardOid: string, options?: GetDashboardOptions) => Promise<DashboardDto | undefined>;
     /**
      * Get all widgets of a specific dashboard
      */

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

@@ -8,9 +8,7 @@ import { FeatureMap } from './types/features.js';
  * it still surfaces via the index signature on {@link AiFeatureFlags}.
  */
 type KnownAiFeatureFlags = {
-    completionV2: boolean;
     naturalResponseEnabled: boolean;
-    nlqV3Enabled: boolean;
     queryDefinition: boolean;
 };
 /**
@@ -27,7 +25,7 @@ export type AiFeatureFlags = KnownAiFeatureFlags & {
 /**
  * AI-related slice derived from globals (`serverFeatures` + deployment props),
  * aligned with admin UI paths such as `ai.featureFlags.*`, `ai.featureModelType`,
- * `ai.quotaNotification`, and `ai.aiStudio.*`.
+ * and `ai.quotaNotification`.
  */
 type AiSettingsSlice = {
     featureFlags: AiFeatureFlags;
@@ -38,10 +36,6 @@ type AiSettingsSlice = {
      */
     featureModelType?: string;
     quotaNotification: boolean;
-    aiStudio: {
-        realtime: boolean;
-        usageDisplay: boolean;
-    };
 };
 /**
  * Application settings

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

@@ -122,22 +122,14 @@ type CloudCDNFeature = Feature<'cloudCDN'>;
 type OnboardingFeature = Feature<'onboarding'>;
 type AiAssistantFeature = Feature<'aiAssistant', {
     unified?: boolean;
-    nlqV3Enabled?: boolean;
-    isNlqV3Enabled?: boolean;
     naturalResponseEnabled?: boolean;
     queryDefinition?: boolean;
-    completionV2?: boolean;
     sharedFormulasEnabled?: boolean;
     aiAccessControl?: string;
     quotaNotification?: boolean;
     featureModelType?: string;
 }>;
-type AiStudioFeature = Feature<'aiStudio', {
-    realtime?: boolean;
-    usageDisplay?: boolean;
-    isRealtimeEnabled?: boolean;
-    isUsageDisplayEnabled?: boolean;
-}>;
+type AiStudioFeature = Feature<'aiStudio'>;
 type NewNavigationBetaFeature = Feature<'newNavigationBeta'>;
 type ApiTelemetryFeature = Feature<'apiTelemetry'>;
 export type Features = (AlertingFeature | LiveQueryFeature | NlqFeature | PivotFeature | CustomCodeFeature | CustomCodeTransformationFeature | BuildDestinationFeature | VersionHistoryFeature | EmbedCodeFeature | LiveCustomColumnFeature | ExportingEngineV2Feature | ExportingXlsxV2Feature | ExportingCsvFeature | ConnectionManagementFeature | SisenseLightFeature | WizardSqlEditorFeature | MultiTenancyFeature | BloxFeature | FunnelFeature | Cloud360Feature | BreakByToggleFeature | GitIntegrationFeature | InfusionFeature | InfusionWebClientFeature | NotebooksFeature | AdminWebClientFeature | DateTimeFiltersFeature | TextFiltersFeature | NumericFiltersFeature | FilterRelationsEnabledFeature | TimeLevelSupportEnabledFeature | SyncDashboardEventsFeature | UserProfileFeature | ScatterFeature | CustomFontsFeature | PreferWidgetImageServerExportFeature | NewAdminUIFeature | SharedFormulasFeature | SideBarFeature | InfusionTokenEndpointFeature | ExplanationsForIndicatorWidgetsFeature | ExplanationsForCategoricalWidgetsFeature | WidgetDesignStyleFeature | FiscalOnFeature | ReactAnalyticsWidgetEditorFeature | DynamicSQLFeature | NewCustomConnectorFeature | CrossTenantPerspectivesFeature | EnableDatamodelPerspectiveFeature | AlwaysDirectRelationsFeature | ModelStatisticsFeature | ExportingCsvFormattedFeature | FlexibleTooltipsFeature | DimensionalModelingFeature | CloudCDNFeature | OnboardingFeature | AiAssistantFeature | AiStudioFeature | NewNavigationBetaFeature | ApiTelemetryFeature)[];