@sisense/sdk-ui 2.30.0 → 2.31.0

package/dist/packages/sdk-ui/src/domains/dashboarding/components/dashboard-header/constants.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Layout constants for the dashboard header.
+ */
+/**
+ * Default (and minimum) dashboard header height (px): the default 28px item plus the 10px top/bottom
+ * padding. The header grows beyond this when an item is taller than the default.
+ */
+export declare const DASHBOARD_HEADER_HEIGHT = 48;
+/**
+ * Default size (px) for dashboard header items that don't specify their own size.
+ */
+export declare const DASHBOARD_HEADER_ITEM_SIZE = 28;
+/**
+ * Gap (px) between adjacent dashboard header items (matches Fusion's 10px spacing).
+ */
+export declare const DASHBOARD_HEADER_ITEMS_GAP = 10;

package/dist/packages/sdk-ui/src/domains/dashboarding/components/{dashboard-header-config.d.ts → dashboard-header/dashboard-header-config.d.ts}

@@ -1,27 +1,28 @@
 import { ReactNode } from 'react';
+import { DashboardHeaderTarget } from './dashboard-header-targets';
 /**
  * Size of a custom dashboard header item, in pixels.
- *
- * @alpha
  */
 export interface DashboardHeaderItemSize {
     /**
      * Fixed width of the item, in pixels.
      *
      * If omitted, it falls back to the default dashboard header item size of `28px`.
+     *
+     * @default 28
      */
     width?: number;
     /**
      * Fixed height of the item, in pixels.
      *
-     * If omitted, falls back to the default dashboard header item size of `28px`.
+     * If omitted, it falls back to the default dashboard header item size of `28px`.
+     *
+     * @default 28
      */
     height?: number;
 }
 /**
  * Props passed to a {@link DashboardHeaderItemComponent} when it is rendered.
- *
- * @alpha
  */
 export interface DashboardHeaderItemComponentProps {
     /** The size resolved for the item by the header layout, with defaults applied. */
@@ -38,29 +39,25 @@ export interface DashboardHeaderItemComponentProps {
 }
 /**
  * A React component that renders the content of a custom dashboard header item.
- *
- * @alpha
  */
 export type DashboardHeaderItemComponent = (props: DashboardHeaderItemComponentProps) => ReactNode;
 /**
  * Position of a custom dashboard header item relative to the other items.
  *
- * - `auto` (default) — placed in the trailing group, after the center spacer.
+ * - `auto` (default) — automatic placement.
  * - `before` / `after` — placed immediately before/after the item with the given `target` id.
  *   Pass a {@link DashboardHeaderTargets} constant to anchor to a built-in item (works even when
  *   that built-in is currently hidden), or any custom item id to anchor to another injected item.
  * - `first` / `last` — placed at the very start/end of the header.
- *
- * @alpha
  */
 export type DashboardHeaderItemPosition = {
     type: 'auto';
 } | {
     type: 'before';
-    target: string;
+    target: DashboardHeaderTarget | string;
 } | {
     type: 'after';
-    target: string;
+    target: DashboardHeaderTarget | string;
 } | {
     type: 'first';
 } | {
@@ -68,8 +65,6 @@ export type DashboardHeaderItemPosition = {
 };
 /**
  * A custom item to inject into the dashboard header.
- *
- * @alpha
  */
 export interface DashboardHeaderItem {
     /**
@@ -97,22 +92,22 @@ export interface DashboardHeaderItem {
  * A dashboard header item after the built-in and custom items have been ordered (position applied).
  *
  * This is the shape passed to {@link DashboardHeaderConfig.onBeforeRender}.
- *
- * @alpha
  */
 export type DashboardResolvedHeaderItem = Omit<DashboardHeaderItem, 'position'>;
 /**
  * Transforms the fully ordered list of dashboard header items right before rendering.
- *
- * @alpha
  */
 export type DashboardHeaderItemsTransform = (items: ReadonlyArray<DashboardResolvedHeaderItem>) => DashboardResolvedHeaderItem[];
 /**
  * Configuration for the dashboard header items.
- *
- * @alpha
  */
 export interface DashboardHeaderConfig {
+    /**
+     * Boolean flag that determines whether the dashboard header is visible.
+     *
+     * If not specified, the default value is `true`.
+     */
+    visible?: boolean;
     /**
      * Custom items to inject into the header.
      *
@@ -120,8 +115,8 @@ export interface DashboardHeaderConfig {
      */
     items?: DashboardHeaderItem[];
     /**
-     * Advanced hook to inspect and rewrite the full, ordered list of header items (built-in +
-     * custom) right before rendering.
+     * Advanced callback to inspect and rewrite the full, ordered list of header items (built-in +
+     * custom) right before rendering. The only way to modify or remove built-in items.
      */
     onBeforeRender?: DashboardHeaderItemsTransform;
 }

package/dist/packages/sdk-ui/src/domains/dashboarding/components/{dashboard-header-targets.d.ts → dashboard-header/dashboard-header-targets.d.ts}

@@ -5,8 +5,6 @@
  * A target stays valid even when it is not currently shown (e.g. the filter toggle when
  * its icon is disabled): the position resolves as if the built-in were there, so the custom item lands
  * in a stable spot regardless of which built-ins happen to be visible.
- *
- * @alpha
  */
 export declare const DashboardHeaderTargets: {
     /** The dashboard title. */
@@ -24,7 +22,5 @@ export declare const DashboardHeaderTargets: {
 };
 /**
  * Union of the built-in dashboard header item ids, usable as `target` for `before`/`after` positions.
- *
- * @alpha
  */
 export type DashboardHeaderTarget = (typeof DashboardHeaderTargets)[keyof typeof DashboardHeaderTargets];

package/dist/packages/sdk-ui/src/domains/dashboarding/components/{dashboard-header-title.d.ts → dashboard-header/dashboard-header-title.d.ts}

@@ -1,4 +1,4 @@
-import { HeaderItem } from '../../../domains/shared/header';
+import { HeaderItem } from '../../../../domains/shared/header';
 /**
  * Props for {@link DashboardHeaderTitle}.
  */

package/dist/packages/sdk-ui/src/domains/dashboarding/components/{dashboard-header.d.ts → dashboard-header/dashboard-header.d.ts}

@@ -1,7 +1,4 @@
-import { DashboardHeaderProps } from '../../../domains/dashboarding/types';
-export declare const DASHBOARD_HEADER_HEIGHT = 48;
-/** Default size (px) for dashboard header items that don't specify their own size. */
-export declare const DASHBOARD_HEADER_ITEM_SIZE = 28;
+import { DashboardHeaderProps } from '../../../../domains/dashboarding/types';
 /**
  * Dashboard header.
  *

package/dist/packages/sdk-ui/src/domains/dashboarding/components/toolbar/edit-toggle.d.ts

@@ -17,6 +17,11 @@ export interface EditToggleProps {
      * Color of the edit toggle button
      */
     color?: string;
+    /**
+     * Size (px) of the square button box, provided by the header layout. Defaults to the dashboard
+     * header item size.
+     */
+    size?: number;
     /**
      * Callback function called when the edit toggle button is clicked
      */

package/dist/packages/sdk-ui/src/domains/dashboarding/components/toolbar/filter-toggle.d.ts

@@ -8,6 +8,11 @@ export interface FilterToggleProps {
      * Color of the filter toggle button
      */
     color?: string;
+    /**
+     * Size (px) of the square button box, provided by the header layout. Defaults to the dashboard
+     * header item size.
+     */
+    size?: number;
     /**
      * Callback function called when the filter toggle button is clicked
      */

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

@@ -1,5 +1,5 @@
 import { Filter, FilterRelations } from '@sisense/sdk-data';
-import { DashboardHeaderItem } from './components/dashboard-header-config.js';
+import { DashboardHeaderItem } from './components/dashboard-header/dashboard-header-config.js';
 import type { JumpToDashboardConfig } from './hooks/jtd/jtd-types.js';
 import { DashboardProps } from './types.js';
 /**

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

@@ -4,6 +4,16 @@ import { RestApi } from '../../../../../infra/api/rest-api';
 import { AppSettings } from '../../../../../infra/app/settings/settings';
 import { CompleteThemeSettingsInternal } from '../../../../../types';
 import { UseDashboardModelInternalAction } from './types.js';
+/**
+ * Returns the Fusion `tableState.colResize.tableSize` for persisted column widths.
+ * Fusion renders each column as `(columnPx / sum(columns)) × tableSize`, so
+ * `tableSize` must equal the sum of column pixel widths for absolute px rendering.
+ *
+ * @param columnWidths - Column pixel widths in display order
+ * @returns Total table width in pixels
+ * @internal
+ */
+export declare function toColResizeTableSize(columnWidths: readonly number[]): number;
 export type PersistDashboardModelMiddlewareParams = {
     /** Dashboard OID, or undefined if not initialized */
     dashboardOid: string | undefined;

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

@@ -1,5 +1,5 @@
 import { Filter, FilterRelations } from '@sisense/sdk-data';
-import { WidgetsPanelLayout } from '../../../domains/dashboarding/dashboard-model';
+import { SpecificWidgetOptions, WidgetsPanelLayout } from '../../../domains/dashboarding/dashboard-model';
 import { DashboardProps } from '../../../domains/dashboarding/types';
 import { WidgetProps } from '../../../domains/widgets/components/widget/types';
 /**
@@ -17,9 +17,16 @@ export interface DashboardStateApi {
      * persistence enabled; otherwise updates local state only.
      *
      * @param widget - The widget to add.
+     * @param options - Optional dashboard-level configuration for the new widget:
+     * - `widgetOptions`: dashboard-level options for the widget (e.g. filtersOptions, jtdConfig).
+     * - `widgetsPanelLayout`: explicit widgets-panel layout describing where the widget is placed;
+     *   When omitted, the widget is appended in a new full-width row at the end of the first column.
      * @returns void
      */
-    addWidget: (widget: WidgetProps) => void;
+    addWidget: (widget: WidgetProps, options?: {
+        widgetOptions?: SpecificWidgetOptions;
+        widgetsPanelLayout?: WidgetsPanelLayout;
+    }) => void;
     /**
      * Replaces the dashboard filters.
      *

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

@@ -4,7 +4,6 @@ import { DashboardProps } from '../../domains/dashboarding/types';
  * React component that renders a dashboard whose elements are customizable. It includes internal logic of applying common filters to widgets.
  *
  * **Note:** Dashboard and Widget extensions based on JS scripts and add-ons in Fusion – for example, Blox and Jump To Dashboard – are not supported.
- *
  * @example
  *
  * Example of rendering a Fusion dashboard using the `useGetDashboardModel hook and the `Dashboard` component.

package/dist/packages/sdk-ui/src/domains/dashboarding/hooks/use-edit-mode-with-history.d.ts

@@ -46,7 +46,6 @@ export interface UseEditModeToolbarResult {
 }
 /**
  * Hook that provides layout state management with history tracking and a toolbar with undo/redo/cancel/apply buttons
- *
  * @param props Configuration options for the toolbar
  * @returns Layout state and toolbar component
  * @internal

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

@@ -5,7 +5,8 @@ type Persistence = Pick<DashboardPersistenceManager, 'updateWidget'> | undefined
  * Composition middleware that adds persistable widget-update plumbing to a
  * widget list. For each widget that exposes a known runtime-state callback
  * (currently only `styleOptions.navigator.onScrollerChange` for charts with
- * a navigator), the hook injects a handler that:
+ * a navigator, and `styleOptions.columns.onColumnsResize` for table charts with
+ * resizable columns), the hook injects a handler that:
  *
  * 1. Applies the update optimistically to local widget state (the parent
  *    `useComposedDashboardInternal` re-renders with the new value).

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

@@ -20,6 +20,9 @@ export type WidgetPropsUpdate = {
                 readonly max: number;
             };
         };
+        readonly columns?: {
+            readonly widths?: ReadonlyArray<number>;
+        };
         /**
          * For custom (plugin) widgets, `styleOptions` is an opaque deeply-partial
          * bag — arbitrary keys are deep-merged into the widget's opaque DTO
@@ -44,7 +47,7 @@ export type WidgetPropsUpdate = {
  * a persistable update for a specific widget. Not part of the public
  * `WidgetProps` surface — composition layer injects handlers into the
  * visualization's existing callback APIs (e.g.
- * `styleOptions.navigator.onScrollerChange`).
+ * `styleOptions.navigator.onScrollerChange`, `styleOptions.columns.onColumnsResize`).
  *
  * @internal
  */

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

@@ -1,5 +1,5 @@
 import { DataSource, Filter, FilterRelations } from '@sisense/sdk-data';
-import { DashboardHeaderConfig } from '../../domains/dashboarding/components/dashboard-header-config';
+import { DashboardHeaderConfig } from '../../domains/dashboarding/components/dashboard-header/dashboard-header-config';
 import { DashboardStyleOptions, WidgetsOptions, WidgetsPanelLayout } from '../../domains/dashboarding/dashboard-model';
 import { TabbersConfig } from '../../domains/dashboarding/hooks/use-tabber';
 import { FiltersPanelConfig } from '../../domains/filters/components/filters-panel/types';
@@ -166,21 +166,34 @@ export interface WidgetsPanelConfig {
      */
     editMode?: EditModeConfig;
     /**
-     * Actions available for all widgets in the panel.
-     *
-     * @sisenseInternal
+     * Configuration for actions available on all widgets in the panel, such as
+     * downloading each widget's data.
      */
     actions?: {
         /**
-         * Configuration for downloading a widget CSV.
+         * Configuration for the "Download as CSV" action on all widgets in the panel,
+         * which adds an item to each widget's header menu that exports the widget's
+         * underlying data as a CSV file.
          *
-         * @sisenseInternal
+         * @example
+         * Enable CSV download for every widget in a dashboard:
+         * ```ts
+         * const dashboardConfig: DashboardConfig = {
+         *   widgetsPanel: {
+         *     actions: {
+         *       downloadCsv: {
+         *         enabled: true,
+         *       },
+         *     },
+         *   },
+         * };
+         * ```
          */
         downloadCsv?: {
             /**
-             * Determines whether the widgets possibility to download a CSV is enabled.
+             * Whether the "Download as CSV" action is enabled for all widgets in the panel.
              *
-             * If not specified, the default value is `false`.
+             * @default false
              */
             enabled?: boolean;
         };
@@ -297,19 +310,21 @@ export interface DashboardConfig {
      */
     filtersPanel?: DashboardFiltersPanelConfig;
     /**
-     * Configuration for the dashboard header
-     *
-     * @alpha
+     * Configuration for the dashboard header.
      */
     header?: DashboardHeaderConfig;
     /**
-     * Configuration for the toolbar
+     * Configuration for the toolbar.
+     *
+     * @deprecated Use the `header` configuration section instead (`header.visible`).
      */
     toolbar?: {
         /**
          * Determines whether the toolbar is visible.
          *
          * If not specified, the default value is `true`.
+         *
+         * @deprecated Use `header.visible` instead.
          */
         visible: boolean;
     };
@@ -360,7 +375,9 @@ export type { DashboardPersistenceManager };
  */
 export interface DashboardProps {
     /**
-     * Optional identifer of the dashboard
+     * Optional unique identifier of the dashboard.
+     *
+     * For dashboards loaded from Fusion (for example, via `DashboardById`), this is populated with the dashboard OID
      *
      * @internal
      */

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

@@ -1,6 +1,19 @@
+import { DataSource } from '@sisense/sdk-data';
 import { WidgetProps } from '../../domains/widgets/components/widget/types';
-import { WidgetsPanelColumnLayout } from './types.js';
+import { ContextfulTransformer } from '../../shared/utils/utility-types/transformer';
+import { DashboardConfig, WidgetsPanelColumnLayout } from './types.js';
 export declare const getDividerStyle: (color: string, width: number) => string;
+/**
+ * Resolves whether the dashboard header is visible from a dashboard config.
+ *
+ * The header is visible unless explicitly disabled. `header.visible` takes precedence; the
+ * deprecated `toolbar.visible` is honored as a fallback for backward compatibility (and emits a
+ * one-time deprecation warning when it is the value in effect).
+ *
+ * @param config - The dashboard config to resolve header visibility from.
+ * @returns Whether the dashboard header should be rendered.
+ */
+export declare const isDashboardHeaderVisible: (config?: DashboardConfig) => boolean;
 /**
  * Gets the default layout for a set of widgets.
  *
@@ -11,14 +24,24 @@ export declare const getDividerStyle: (color: string, width: number) => string;
  */
 export declare const getDefaultWidgetsPanelLayout: (widgets: WidgetProps[]) => WidgetsPanelColumnLayout;
 /**
- * Returns a copy of the layout with a new full-width row holding `widgetId` appended to the first
- * column (a column is created if the layout has none). Pure; does not mutate the input.
+ * Contextful transformer that returns a copy of the layout with a new full-width row holding
+ * `widgetId` appended to the end of the first column (a column is created if the layout has none).
  *
- * @param layout - The current widgets-panel layout.
  * @param widgetId - The id of the widget to append.
- * @returns The layout with the widget appended.
+ * @returns A transformer over a widgets-panel layout.
+ */
+export declare const withWidgetAppendedToPanelLayout: ContextfulTransformer<WidgetsPanelColumnLayout, string>;
+/**
+ * Contextful transformer that resolves the data source for a widget being added to a dashboard.
+ *
+ * Keeps the widget's own `dataSource` when present; otherwise fills it from the first defined
+ * fallback (e.g. the dashboard default, then the app default). Text widgets, which have no data
+ * source, are returned unchanged.
+ *
+ * @param fallbackDataSources - Ordered fallback data sources; the first defined one is used.
+ * @returns A transformer over a widget that resolves its `dataSource`.
  */
-export declare const withWidgetAppendedToPanelLayout: (layout: WidgetsPanelColumnLayout, widgetId: string) => WidgetsPanelColumnLayout;
+export declare const withResolvedWidgetDataSource: ContextfulTransformer<WidgetProps, Array<DataSource | undefined>>;
 /**
  * With optionally disabled auto height.
  *

package/dist/packages/sdk-ui/src/domains/filters/components/filters-panel/filters-panel.d.ts

@@ -51,7 +51,6 @@ export interface FiltersPanelProps {
  *   );
  * }
  * ```
- *
  * @group Filter Tiles
  */
 export declare const FiltersPanel: import("react").FunctionComponent<FiltersPanelProps>;

package/dist/packages/sdk-ui/src/domains/narrative/components/widget-narrative.d.ts

@@ -5,7 +5,7 @@ import type { HookEnableParam } from '../../../shared/hooks/types';
  * Props for {@link WidgetNarrative}.
  *
  * @remarks
- * Narrative options are read from `widgetProps.aiOptions.narrative` for chart and pivot widgets.
+ * Narrative options are read from `widgetProps.config.narrative` for chart and pivot widgets.
  * Accepts {@link HookEnableParam}; `enabled` is forwarded to {@link useWidgetNarrativeState}.
  * @sisenseInternal
  */

package/dist/packages/sdk-ui/src/domains/narrative/core/get-widget-narrative-from-widget-props.d.ts

@@ -1,18 +1,18 @@
+import type { WidgetNarrativeConfig } from '../../../domains/narrative/core/widget-narrative-config';
 import type { ChartWidgetProps } from '../../../domains/widgets/components/chart-widget/types.js';
 import type { PivotTableWidgetProps } from '../../../domains/widgets/components/pivot-table-widget/types.js';
 import type { WidgetProps } from '../../../domains/widgets/components/widget/types.js';
-import type { WidgetNarrativeOptions } from '../../../types.js';
 type WidgetPropsWithNarrativeSupport = ChartWidgetProps | PivotTableWidgetProps | Extract<WidgetProps, {
     widgetType: 'chart';
 } | {
     widgetType: 'pivot';
 }>;
 /**
- * Returns narrative options from chart or pivot widget props (`aiOptions.narrative`).
+ * Returns narrative config from chart or pivot widget props (`config.narrative`).
  *
  * @param props - Chart or pivot widget props (standalone or {@link WidgetProps} chart/pivot branches)
- * @returns `WidgetNarrativeOptions` when present
+ * @returns `WidgetNarrativeConfig` when present
  * @internal
  */
-export declare function getWidgetNarrativeOptionsFromWidgetProps(props: WidgetPropsWithNarrativeSupport): WidgetNarrativeOptions | undefined;
+export declare function getWidgetNarrativeConfigFromWidgetProps(props: WidgetPropsWithNarrativeSupport): WidgetNarrativeConfig | undefined;
 export {};

package/dist/packages/sdk-ui/src/domains/narrative/core/{widget-narrative-options.d.ts → widget-narrative-config.d.ts}

@@ -6,15 +6,14 @@
  * - `alone`: displayed alone, without any other widget content
  *
  * @default 'above'
- * @alpha
  */
 export type WidgetNarrativeDisplayLocation = 'above' | 'below' | 'alone';
 /**
  * Narrative configuration options for widgets.
  *
- * @alpha
+ * Set on a chart or pivot widget via {@link WidgetConfig}.
  */
-export type WidgetNarrativeOptions = {
+export type WidgetNarrativeConfig = {
     /**
      * Verbosity for narrative generation.
      *
@@ -22,6 +21,8 @@ export type WidgetNarrativeOptions = {
      */
     verbosity?: 'low' | 'high';
     /**
+     * Whether to include trend and forecast in the narrative.
+     *
      * When `true`, any trend and forecast companion measures present on the widget are included in the narrative request.
      *
      * When `false`, they are not included in the narrative request.
@@ -30,6 +31,8 @@ export type WidgetNarrativeOptions = {
      */
     includeTrendAndForecast?: boolean;
     /**
+     * Whether the narrative is enabled for the widget.
+     *
      * When `true`, narrative is enabled for the widget.
      *
      * When `false`, narrative is disabled for the widget and will not be generated.
@@ -82,17 +85,15 @@ export type WidgetNarrativeOptions = {
      * Practical guidelines:
      * - Values above `~0.8` leave very little room for the chart.
      * - Values below `~0.1` may clip the collapsed narrative text (~46 px).
-     * - Has no effect when {@link WidgetNarrativeOptions.displayLocation | displayLocation} is `'alone'`
+     * - Has no effect when {@link WidgetNarrativeConfig.displayLocation | displayLocation} is `'alone'`
      *   (the chart is already hidden in that mode).
      */
     heightFraction?: number;
 };
 /**
- * {@link WidgetNarrativeOptions} with all optional fields filled using {@link getCompleteWidgetNarrativeOptions}.
- *
- * @alpha
+ * {@link WidgetNarrativeConfig} with all optional fields filled using {@link getCompleteWidgetNarrativeConfig}.
  */
-export type CompleteWidgetNarrativeOptions = {
+export type CompleteWidgetNarrativeConfig = {
     enabled: boolean;
     verbosity: 'low' | 'high';
     displayLocation: WidgetNarrativeDisplayLocation;
@@ -101,14 +102,13 @@ export type CompleteWidgetNarrativeOptions = {
     feedback: {
         enabled: boolean;
     };
-    /** Resolved from {@link WidgetNarrativeOptions.heightFraction}. `undefined` means no constraint. */
+    /** Resolved from {@link WidgetNarrativeConfig.heightFraction}. `undefined` means no constraint. */
     heightFraction: number | undefined;
 };
 /**
- * Returns {@link WidgetNarrativeOptions} with defaults applied for runtime.
+ * Returns {@link WidgetNarrativeConfig} with defaults applied for runtime.
  *
  * @param narrative - Optional narrative configuration to apply defaults to
  * @returns Complete narrative configuration with defaults applied
- * @alpha
  */
-export declare function getCompleteWidgetNarrativeOptions(narrative?: WidgetNarrativeOptions): CompleteWidgetNarrativeOptions;
+export declare function getCompleteWidgetNarrativeConfig(narrative?: WidgetNarrativeConfig): CompleteWidgetNarrativeConfig;

package/dist/packages/sdk-ui/src/domains/narrative/core/widget-props-to-narrative-params.d.ts

@@ -4,12 +4,12 @@ import type { PivotTableWidgetProps } from '../../../domains/widgets/components/
 import type { WidgetProps, WithCommonWidgetProps } from '../../../domains/widgets/components/widget/types';
 import type { NarrativeRequest } from '../../../infra/api/narrative/narrative-api-types.js';
 import type { NarrativeQueryParams } from './build-narrative-request.js';
-import { type CompleteWidgetNarrativeOptions } from './widget-narrative-options.js';
+import { type CompleteWidgetNarrativeConfig } from './widget-narrative-config.js';
 /**
  * Converts ChartWidgetProps to {@link NarrativeQueryParams} by extracting dimensions and measures
  * from the chart data options.
  *
- * @param props - ChartWidgetProps to convert. `aiOptions.narrative` supplies {@link WidgetNarrativeOptions}. Defaults are calculated via {@link getCompleteWidgetNarrativeOptions})
+ * @param props - ChartWidgetProps to convert. `config.narrative` supplies {@link WidgetNarrativeConfig}. Defaults are calculated via {@link getCompleteWidgetNarrativeConfig}
  * @param defaultDataSource - Optional default data source to use if props.dataSource is undefined
  * @returns Params ready for {@link prepareNarrativeRequest}
  * @throws If neither `props.dataSource` nor `defaultDataSource` is set
@@ -20,8 +20,8 @@ export declare function convertChartWidgetPropsToNarrativeParams(props: ChartWid
  * Builds a narrative API request from pivot widget props using the same JAQL as pivot query
  * execution ({@link getPivotJaqlQueryPayload}).
  *
- * @param props - Pivot widget props (`widgetType: 'pivot'`); `aiOptions.narrative` supplies
- *   {@link WidgetNarrativeOptions} via {@link getWidgetNarrativeOptionsFromWidgetProps}
+ * @param props - Pivot widget props (`widgetType: 'pivot'`); `config.narrative` supplies
+ *   {@link WidgetNarrativeConfig} via {@link getWidgetNarrativeConfigFromWidgetProps}
  * @param defaultDataSource - Used when `props.dataSource` is undefined
  * @returns Request ready for `getNarrative`
  * @throws If data source cannot be resolved, or pivot query description is invalid
@@ -44,13 +44,13 @@ export declare const convertChartWidgetPropsToUseGetNlgInsightsParams: typeof co
  */
 export declare function convertWidgetPropsToNarrativeParams(props: WithCommonWidgetProps<ChartWidgetProps, 'chart'> | WithCommonWidgetProps<PivotTableWidgetProps, 'pivot'>, defaultDataSource?: DataSource): NarrativeRequest;
 /**
- * Completes widget narrative options from chart/pivot `WidgetProps` for NLG (`aiOptions.narrative`).
+ * Completes widget narrative options from chart/pivot `WidgetProps` for NLG (`config.narrative`).
  *
  * @param props - Widget props (chart, pivot, or other)
  * @returns Complete narrative defaults for non-chart/pivot types
  * @internal
  */
-export declare function getCompleteWidgetNarrativeOptionsFromWidgetProps(props: WidgetProps): CompleteWidgetNarrativeOptions;
+export declare function getCompleteWidgetNarrativeConfigFromWidgetProps(props: WidgetProps): CompleteWidgetNarrativeConfig;
 /**
  * Error message for imperative callers (e.g. {@link getNlgInsightsFromWidget}) when chart or pivot widget
  * props omit `dataSource`, no defaultDataSource can be resolved from app context, and no defaultDataSource is provided.
@@ -82,8 +82,8 @@ export type WidgetNarrativeRequestPair = {
  * @returns `{ supported, narrativeRequest, narrativeFallbackRequest }`. `supported` is `false`
  *   when the widget type is unsupported, when no data source can be resolved for chart/pivot, or
  *   when the primary conversion fails.
- * @remarks {@link WidgetNarrativeOptions} are derived from `props.aiOptions?.narrative`
- *   via {@link getWidgetNarrativeOptionsFromWidgetProps} and {@link getCompleteWidgetNarrativeOptions}.
+ * @remarks {@link WidgetNarrativeConfig} are derived from `props.config?.narrative`
+ *   via {@link getWidgetNarrativeConfigFromWidgetProps} and {@link getCompleteWidgetNarrativeConfig}.
  * @internal
  */
 export declare function buildWidgetNarrativeRequests(props: WidgetProps, defaultDataSource?: DataSource): WidgetNarrativeRequestPair;

package/dist/packages/sdk-ui/src/domains/narrative/hooks/use-get-widget-narrative.d.ts

@@ -6,8 +6,8 @@ import { type WidgetNarrativeQueryState } from './use-widget-narrative-state.js'
  *
  * @remarks
  * Narrative endpoint selection uses `app.settings.narrative.canGenerateNarrativeViaAI` from
- * {@link useSisenseContext}. {@link WidgetNarrativeOptions} come from
- * `widgetProps.aiOptions.narrative` (see {@link getCompleteWidgetNarrativeOptions}).
+ * {@link useSisenseContext}. {@link WidgetNarrativeConfig} come from
+ * `widgetProps.config.narrative` (see {@link getCompleteWidgetNarrativeConfig}).
  *
  * The `enabled` flag follows {@link HookEnableParam} (defaults to `true` when omitted).
  * @sisenseInternal

package/dist/packages/sdk-ui/src/domains/shared/header/header-item-cell.d.ts

@@ -0,0 +1,25 @@
+import { ResolvedHeaderItem } from './types.js';
+/**
+ * Props for {@link HeaderItemCell}.
+ */
+export interface HeaderItemCellProps {
+    /** The resolved header item to render. */
+    item: ResolvedHeaderItem;
+    /**
+     * Default size (px) applied when the item doesn't specify one, letting each host pick its own
+     * default (the dashboard uses 28). Defaults to {@link DEFAULT_HEADER_ITEM_SIZE}.
+     */
+    defaultSize?: number;
+}
+/**
+ * Renders a single header item.
+ *
+ * This is the **header item component** every item flows through: it owns the item's layout box —
+ * the width behavior (from the internal `fill`), the orchestrator-provided height, and centering the
+ * content on both axes — so individual items only render their content and never manage header
+ * alignment themselves.
+ *
+ * An item shorter than the cell height is centered vertically; an item taller than the default grows
+ * its cell (and, via the row's `align-items: center`, the whole header) while staying centered.
+ */
+export declare const HeaderItemCell: ({ item, defaultSize }: HeaderItemCellProps) => import("react/jsx-runtime").JSX.Element;