@sisense/sdk-ui 2.23.0 → 2.25.0

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-data-options/apply-styled-options-to-query.d.ts

@@ -0,0 +1,87 @@
+import { Attribute, CalculatedMeasureColumn, Column, Measure, MeasureColumn } from '@sisense/sdk-data';
+import type { CategoryStyle, SeriesStyle, StyledColumn, StyledMeasureColumn, ValueStyle } from './types.js';
+/**
+ * Name prefixes for trend and forecast measures in query payloads (aligned with NLQ JSON and chart).
+ *
+ * @internal
+ */
+export declare const TREND_PREFIX = "$trend";
+export declare const FORECAST_PREFIX = "$forecast";
+/**
+ * Dimension + optional category style for {@link adaptDimensionsForQuery}.
+ * Structurally matches NLQ `DimensionTranslationItem`.
+ *
+ * @internal
+ */
+export type DimensionQueryAdaptItem = {
+    attribute: Attribute;
+    style?: CategoryStyle;
+};
+/**
+ * Measure + optional value style for {@link adaptMeasuresForQuery}.
+ * Structurally matches NLQ `MeasureTranslationItem`.
+ *
+ * @internal
+ */
+export type MeasureQueryAdaptItem = {
+    measure: Measure;
+    style?: ValueStyle & SeriesStyle;
+};
+/**
+ * Dimensional {@link Attribute} instances expose JAQL sort APIs; plain {@link Column} does not.
+ *
+ * @internal
+ */
+export declare function isDimensionalAttribute(column: Column): column is Attribute;
+/**
+ * Narrative / NLQ query measures are dimensional {@link Measure} instances (e.g. from `measureFactory`).
+ *
+ * @internal
+ */
+export declare function isDimensionalMeasure(column: MeasureColumn | CalculatedMeasureColumn): column is Measure;
+/**
+ * Builds a dimension adapt item using `StyledColumn`’s own shape (no `splitColumn` merge).
+ *
+ * @internal
+ */
+export declare function toDimensionQueryAdaptItem(sc: StyledColumn): DimensionQueryAdaptItem;
+/**
+ * Builds a measure adapt item using `StyledMeasureColumn`’s own shape (no `splitColumn` merge).
+ *
+ * @internal
+ */
+export declare function toMeasureQueryAdaptItem(smc: StyledMeasureColumn): MeasureQueryAdaptItem;
+/**
+ * Applies sort from styled dimensions to attributes (NLQ JSON → query semantics).
+ *
+ * @internal
+ */
+export declare function adaptDimensionsForQuery(items: DimensionQueryAdaptItem[]): Attribute[];
+/**
+ * @internal
+ */
+export declare function isTrendMeasure(measure: Measure): boolean;
+/**
+ * @internal
+ */
+export declare function isForecastMeasure(measure: Measure): boolean;
+/**
+ * Options for {@link adaptMeasuresForQuery}.
+ *
+ * @internal
+ */
+export type AdaptMeasuresForQueryOptions = {
+    /**
+     * When `true`, trend and forecast companion measures are not appended (e.g. narrative when the
+     * backend does not yet support them).
+     *
+     * @default false
+     */
+    ignoreTrendAndForecast?: boolean;
+};
+/**
+ * Applies sort, trend, and forecast companion measures (NLQ JSON → query semantics).
+ *
+ * @internal
+ */
+export declare function adaptMeasuresForQuery(items: MeasureQueryAdaptItem[], options?: AdaptMeasuresForQueryOptions): Measure[];

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-data-options/translate-data-options.d.ts

@@ -1,8 +1,20 @@
 import { Attribute, Measure } from '@sisense/sdk-data';
 import { ChartType } from '../../../../types';
-import { CategoricalChartDataOptions, CategoricalChartDataOptionsInternal, ChartDataOptions, ChartDataOptionsInternal, PivotTableDataOptions, PivotTableDataOptionsInternal, TableDataOptions, TableDataOptionsInternal } from './types';
+import { CategoricalChartDataOptions, CategoricalChartDataOptionsInternal, ChartDataOptions, ChartDataOptionsInternal, PivotTableDataOptions, PivotTableDataOptionsInternal, StyledColumn, StyledMeasureColumn, TableDataOptions, TableDataOptionsInternal } from './types';
 export declare function translateChartDataOptions(chartType: ChartType, dataOptions: ChartDataOptions): ChartDataOptionsInternal;
 export declare const translateCategoricalChartDataOptions: (categorical: CategoricalChartDataOptions) => CategoricalChartDataOptionsInternal;
+/**
+ * Styled dimension columns used by charts for the same axes as {@link getAttributes}.
+ *
+ * @internal
+ */
+export declare function getStyledDimensionColumns(dataOptions: ChartDataOptionsInternal, chartType: ChartType): StyledColumn[];
+/**
+ * Styled measure columns used by charts for the same axes as {@link getMeasures}.
+ *
+ * @internal
+ */
+export declare function getStyledMeasureColumns(dataOptions: ChartDataOptionsInternal, chartType: ChartType): StyledMeasureColumn[];
 export declare function getAttributes(dataOptions: ChartDataOptionsInternal, chartType: ChartType): Attribute[];
 export declare function getMeasures(dataOptions: ChartDataOptionsInternal, chartType: ChartType): Measure[];
 export declare function translateTableDataOptions(dataOptions: TableDataOptions): TableDataOptionsInternal;

package/dist/packages/sdk-ui/src/domains/visualizations/core/query-definition/compose-code-to-readable.d.ts

@@ -0,0 +1,12 @@
+import type { FunctionCall } from '@sisense/sdk-data';
+import type { QueryPillItem } from './types';
+export type TooltipModel = {
+    layoutText: string;
+    typeLabel: 'Measure' | 'Dimension' | 'Filter';
+    column: string;
+    formula: string;
+};
+/** @internal */
+export declare function functionCallToString(functionCall: FunctionCall, ignoreArgs?: string[]): string;
+/** @internal */
+export declare function getQueryPillTooltipModel(item: QueryPillItem): TooltipModel | null;

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

@@ -0,0 +1,6 @@
+export { QueryDefinition } from './query-definition';
+export type { QueryDefinitionProps } from './query-definition';
+export { QueryPill } from './query-pill';
+export type { QueryPillProps } from './query-pill';
+export type { QueryPillCategory, QueryPillItem, ConnectorItem, QueryDefinitionViewModel, } from './types';
+export { isConnectorItem, isPillItem } from './types';

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

@@ -0,0 +1,26 @@
+import { type FunctionComponent } from 'react';
+import type { BaseQueryParams } from '../../../../domains/query-execution/types';
+import type { ChartProps } from '../../../../props';
+/**
+ * Props for the QueryDefinition component.
+ *
+ * @sisenseInternal
+ */
+export interface QueryDefinitionProps {
+    /** Either chart props (uses getTranslatedDataOptions internally) or base query params */
+    query: BaseQueryParams | ChartProps;
+    /** When true (default), pills show JSON tooltip on hover. */
+    showTooltip?: boolean;
+    /**
+     * Optional DOM box to clamp tooltips (e.g. chart card). Omit for viewport-only — the component
+     * root is only one row tall and must not be used as boundary (breaks vertical placement).
+     */
+    tooltipBoundaryElement?: HTMLElement | null;
+}
+/**
+ * Read-only query definition as colored pills above the widget.
+ * Order: Measures → Dimensions → Filters; collapsed to 4 pills with “Show N more” / “Show less”.
+ *
+ * @sisenseInternal
+ */
+export declare const QueryDefinition: FunctionComponent<QueryDefinitionProps>;

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

@@ -0,0 +1,12 @@
+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
+ * @returns QueryDefinitionViewModel (pills and connectors)
+ * @internal
+ */
+export declare function baseQueryParamsToViewModel(params: BaseQueryParams): 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,13 @@
+import type { FunctionComponent } from 'react';
+import type { QueryPillItem } from './types';
+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.
+ *
+ * @internal
+ */
+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/chart-widget/use-chart-widget-csv-download.d.ts

@@ -0,0 +1,18 @@
+import type { WidgetHeaderConfig } from '../../../../domains/widgets/shared/widget-header/types.js';
+import type { ChartWidgetProps } from './types.js';
+export type UseChartWidgetCsvDownloadParams = Pick<ChartWidgetProps, 'title' | 'dataOptions' | 'chartType' | 'filters' | 'highlights' | 'config' | 'dataSource'> & {
+    /** Base header config */
+    baseHeaderConfig: WidgetHeaderConfig;
+};
+export type UseChartWidgetCsvDownloadResult = {
+    headerConfig: WidgetHeaderConfig;
+};
+/**
+ * Enhances a chart widget's header with CSV download capabilities:
+ * - Adds the "Download > CSV File" header menu item.
+ * - Executes the CSV query and downloads the result as a CSV file.
+ *
+ * @param props - Chart widget props and base header config
+ * @returns Header config for {@link WidgetContainer}
+ */
+export declare function useChartWidgetCsvDownload(props: UseChartWidgetCsvDownloadParams): UseChartWidgetCsvDownloadResult;

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

@@ -0,0 +1,15 @@
+import type { WidgetHeaderConfig } from '../../../../domains/widgets/shared/widget-header/types.js';
+import type { CustomWidgetProps } from './types.js';
+export type UseCustomWidgetCsvDownloadParams = Pick<CustomWidgetProps, 'title' | 'dataOptions' | 'filters' | 'highlights' | 'config' | 'dataSource'>;
+export type UseCustomWidgetCsvDownloadResult = {
+    headerConfig: WidgetHeaderConfig;
+};
+/**
+ * Enhances a custom widget's header with CSV download capabilities:
+ * - Adds the "Download > CSV File" header menu item.
+ * - Executes the CSV query and downloads the result as a CSV file.
+ *
+ * @param widgetProps - Custom widget props needed for CSV
+ * @returns Header config for {@link WidgetContainer}
+ */
+export declare function useCustomWidgetCsvDownload(widgetProps: UseCustomWidgetCsvDownloadParams): UseCustomWidgetCsvDownloadResult;

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

@@ -0,0 +1,18 @@
+import type { WidgetHeaderConfig } from '../../../../domains/widgets/shared/widget-header/types.js';
+import type { PivotTableWidgetProps } from './types.js';
+export type UsePivotWidgetCsvDownloadParams = Pick<PivotTableWidgetProps, 'title' | 'dataOptions' | 'filters' | 'highlights' | 'config' | 'dataSource'> & {
+    /** Header config from {@link useWidgetHeaderManagement} (rename menu, etc.). */
+    baseHeaderConfig: WidgetHeaderConfig;
+};
+export type UsePivotWidgetCsvDownloadResult = {
+    headerConfig: WidgetHeaderConfig;
+};
+/**
+ * Enhances a pivot table widget's header with CSV download capabilities:
+ * - Adds the "Download > CSV File" header menu item.
+ * - Executes the CSV query and downloads the result as a CSV file.
+ *
+ * @param props - Pivot widget props and base header config
+ * @returns Header config for {@link WidgetContainer}
+ */
+export declare function usePivotWidgetCsvDownload(props: UsePivotWidgetCsvDownloadParams): UsePivotWidgetCsvDownloadResult;

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

@@ -4,10 +4,6 @@ import { CustomWidgetProps } from '../../../../domains/widgets/components/custom
  *
  */
 export type TabberButtonsWidgetStyleOptions = {
-    /**
-     * Color of the widget description text
-     */
-    descriptionColor?: string;
     /**
      * Background color of the selected tab
      */
@@ -22,6 +18,14 @@ export type TabberButtonsWidgetStyleOptions = {
      * @defaultValue true
      */
     showDescription?: boolean;
+    /**
+     * Description text displayed in the tabber widget (when showDescription is true)
+     */
+    description?: string;
+    /**
+     * Color of the widget description text
+     */
+    descriptionColor?: string;
     /**
      * Whether to show visual separators between tabs
      *
@@ -120,8 +124,4 @@ export interface TabberButtonsWidgetProps extends CustomWidgetProps {
      * Configuration for tabs including names and active tab index
      */
     customOptions: TabberButtonsWidgetCustomOptions;
-    /**
-     * Description text displayed in the widget
-     */
-    description?: string;
 }

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

@@ -5,7 +5,7 @@ import type { CustomWidgetProps } from '../custom-widget/types';
 import type { PivotTableWidgetProps } from '../pivot-table-widget/types';
 import type { TextWidgetProps } from '../text-widget/types';
 /**
- * Generic widget configuration (e.g. header menu, toolbar).
+ * Generic widget configuration (e.g. header menu, toolbar, actions).
  * Shared across chart, pivot, text, and custom widgets.
  */
 export type WidgetConfig = {
@@ -13,6 +13,26 @@ export type WidgetConfig = {
      * Configurations for the widget header (e.g. toolbar menu items)
      */
     header?: WidgetHeaderConfig;
+    /**
+     * Configuration for widget actions.
+     *
+     * @sisenseInternal
+     */
+    actions?: {
+        /**
+         * Configuration for downloading a CSV file.
+         *
+         * @sisenseInternal
+         */
+        downloadCsv?: {
+            /**
+             * Determines whether the possibility to download a CSV is enabled.
+             *
+             * If not specified, the default value is `false`.
+             */
+            enabled?: boolean;
+        };
+    };
 };
 /**
  * Type of the widget component.

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,6 @@
-import type { AxisLabel, DataLimits, LegendOptions, LineStyleOptions, LineWidth, Markers, Navigator, SeriesLabels } from '../../../../../types.js';
-import type { AxisStyle, CartesianWidgetStyle } from '../types.js';
+import { AppSettings } from '../../../../../infra/app/settings/settings.js';
+import type { AreaStyleOptions, AxisLabel, CompleteThemeSettings, DataLimits, IndicatorStyleOptions, LegendOptions, LineStyleOptions, LineWidth, Markers, Navigator, PieStyleOptions, SeriesLabels, WidgetStyleOptions } from '../../../../../types.js';
+import type { AxisStyle, CartesianWidgetStyle, WidgetDesign, WidgetStyle, WidgetSubtype } from '../types.js';
 /**
  * Maps SDK legend options to Fusion DTO legend style.
  *
@@ -51,6 +52,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.
@@ -60,4 +108,13 @@ export declare function toDataLimitsStyle(dataLimits?: DataLimits): CartesianWid
  * @internal
  */
 export declare function toLineWidgetStyle(styleOptions: LineStyleOptions): CartesianWidgetStyle;
+/**
+ * Converts area chart style options to Fusion CartesianWidgetStyle DTO.
+ * Used when serializing an area chart widget back to WidgetDto.
+ *
+ * @param styleOptions - Area style options from WidgetModel.styleOptions
+ * @param widgetSubtype - Resolved Fusion widget subtype (e.g. after `area/basic` default)
+ * @returns Fusion CartesianWidgetStyle for the widget DTO
+ */
+export declare function toAreaWidgetStyle(styleOptions: AreaStyleOptions, widgetSubtype: WidgetSubtype): CartesianWidgetStyle;
 export {};

package/dist/packages/sdk-ui/src/domains/widgets/hooks/use-csv-query-file-loader.d.ts

@@ -0,0 +1,16 @@
+import type { ExecuteCsvQueryParams } from '../../../domains/query-execution/types.js';
+export type CsvExecuteParams = Omit<ExecuteCsvQueryParams, 'enabled'> & {
+    /** Filename for the downloaded CSV file. Defaults to `data.csv`. */
+    filename?: string;
+};
+export type UseCsvQueryLoaderResult = {
+    /** Triggers CSV query execution and browser file download with the given params. */
+    execute: (params: CsvExecuteParams) => void;
+};
+/**
+ * Hook that executes a CSV query on demand and triggers a browser file download.
+ * Call `execute` with query params to start the download; no params are needed at hook initialisation.
+ *
+ * @returns `execute` callback
+ */
+export declare function useCsvQueryFileLoader(): UseCsvQueryLoaderResult;

package/dist/packages/sdk-ui/src/domains/widgets/hooks/use-with-csv-download-menu-item.d.ts

@@ -0,0 +1,22 @@
+import type { WidgetHeaderConfig } from '../../../domains/widgets/shared/widget-header/types.js';
+export type UseWithCsvDownloadMenuParams = {
+    /** Base header config. */
+    baseHeaderConfig: WidgetHeaderConfig;
+    /** Whether the "Download CSV" menu item is enabled. */
+    enabled: boolean;
+    /** Triggers CSV query execution and browser download. */
+    onClick: () => void;
+};
+/**
+ * Appends a "Download > CSV File" item to the widget header menu when enabled.
+ *
+ * If a "Download" group already exists in the menu, the "CSV File" item is added to its `items`.
+ * Otherwise a new "Download" group containing "CSV File" is appended.
+ *
+ * @param params.baseHeaderConfig - Base header config.
+ * @param params.enabled - Whether the "Download CSV" menu item is enabled.
+ * @param params.onClick - Click handler for the "CSV File" leaf item.
+ * @returns Header config to pass to {@link WidgetContainer}
+ * @internal
+ */
+export declare function useWithCsvDownloadMenuItem({ baseHeaderConfig, enabled, onClick, }: UseWithCsvDownloadMenuParams): WidgetHeaderConfig;

package/dist/packages/sdk-ui/src/domains/widgets/shared/widget-header/widget-menu-button.d.ts

@@ -1,4 +1,4 @@
-import { MenuItem } from '../../../../shared/types/menu-item';
+import type { MenuItem } from '../../../../shared/types/menu-item';
 export interface WidgetMenuButtonProps {
     menuItems: MenuItem[];
 }

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

@@ -175,7 +175,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";

package/dist/packages/sdk-ui/src/{modules/ai/api/narration-endpoints.d.ts → infra/api/narrative/narrative-endpoints.d.ts}

@@ -1,19 +1,20 @@
 import type { HttpClient } from '@sisense/sdk-rest-client';
-import type { GetNlgInsightsRequest, GetNlgInsightsResponse } from './types.js';
+import type { NarrativeRequest, NarrativeResponse } from './narrative-api-types.js';
 /** Unified narrative endpoint. Try first; fall back to legacy on 404. */
-export declare const UNIFIED_NARRATION_ENDPOINT = "api/v2/ai/narrative";
+export declare const UNIFIED_NARRATIVE_ENDPOINT = "api/v2/ai/narrative";
 /** Legacy endpoint (used when unified narrative returns 404). */
-export declare const LEGACY_NARRATION_ENDPOINT = "api/v2/ai/nlg/queryResult";
+export declare const LEGACY_NARRATIVE_ENDPOINT = "api/v2/ai/nlg/queryResult";
 /**
- * Options for getNarrations. All endpoint choice logic lives in this module.
+ * Options for getNarrative. All endpoint choice logic lives in this module.
+ *
  * @internal
  */
-export type GetNarrationsOptions = {
+export type GetNarrativeOptions = {
     isUnifiedNarrationEnabled?: boolean;
     isSisenseAiEnabled?: boolean;
 };
 /**
- * Fetches narrations. Single place for endpoint logic: isUnifiedNarrationEnabled === false → legacy only;
+ * Fetches Narrative. Single place for endpoint logic: isUnifiedNarrationEnabled === false → legacy only;
  * otherwise try unified endpoint first, fall back to legacy on 404.
  *
  * @param httpClient - HttpClient instance
@@ -22,4 +23,4 @@ export type GetNarrationsOptions = {
  * @returns Promise with narration response
  * @internal
  */
-export declare function getNarrations(httpClient: HttpClient, request: GetNlgInsightsRequest, options?: GetNarrationsOptions): Promise<GetNlgInsightsResponse>;
+export declare function getNarrative(httpClient: HttpClient, request: NarrativeRequest, options?: GetNarrativeOptions): Promise<NarrativeResponse>;

package/dist/packages/sdk-ui/src/infra/api/narrative/send-ai-feedback.d.ts

@@ -0,0 +1,8 @@
+import type { HttpClient } from '@sisense/sdk-rest-client';
+import type { SendAiFeedbackRequest } from './narrative-api-types.js';
+/**
+ * Posts AI / chart insight feedback (thumbs).
+ *
+ * @internal
+ */
+export declare function sendAiFeedback(httpClient: HttpClient, request: SendAiFeedbackRequest): Promise<unknown>;

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

@@ -1,11 +1,11 @@
 import { SisenseContextProviderProps } from '../../index';
 import { type ClientApplication } from './types';
-type ClientApplicationParams = Pick<SisenseContextProviderProps, 'appConfig' | 'defaultDataSource' | 'url' | 'token' | 'wat' | 'ssoEnabled' | 'enableSilentPreAuth' | 'useFusionAuth' | 'alternativeSsoHost' | 'disableFusionPalette'> & {
+type ClientApplicationParams = Pick<SisenseContextProviderProps, 'appConfig' | 'defaultDataSource' | 'url' | 'token' | 'wat' | 'ssoEnabled' | 'enableSilentPreAuth' | 'useFusionAuth' | 'alternativeSsoHost' | 'ssoMaxAuthRedirectAttempts' | 'ssoRedirectAttemptsTtlMs' | 'disableFusionPalette'> & {
     /**
      * @internal
      */
     packageName?: string;
 };
 /** @internal */
-export declare const createClientApplication: ({ defaultDataSource, url: rawUrl, token, wat, ssoEnabled, appConfig, enableSilentPreAuth, useFusionAuth, alternativeSsoHost, disableFusionPalette, packageName, }: ClientApplicationParams) => Promise<ClientApplication>;
+export declare const createClientApplication: ({ defaultDataSource, url: rawUrl, token, wat, ssoEnabled, appConfig, enableSilentPreAuth, useFusionAuth, alternativeSsoHost, ssoMaxAuthRedirectAttempts, ssoRedirectAttemptsTtlMs, disableFusionPalette, packageName, }: ClientApplicationParams) => Promise<ClientApplication>;
 export {};

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

@@ -10,7 +10,8 @@ export type CustomWidgetsContextAdapter<T = CustomWidgetComponentProps> = {
 /**
  * Custom Widget Provider Adapter component that allows passing external custom widgets context.
  *
- * Note: it is designed to serve as a bridge for passing pre-initialized custom widget data between an external wrapper and child React components.
+ * Bridges pre-initialized custom widget data from an external wrapper to child React components.
+ * Syncs the widget registry with customWidgetsMap on updates and cleans up on unmount.
  *
  * @internal
  */