@sisense/sdk-ui 2.27.0 → 2.29.0

package/dist/packages/sdk-ui/src/modules/analytics-composer/types.d.ts

@@ -1,4 +1,4 @@
-import { JaqlDataSourceForDto, JSONArray, MetadataItem } from '@sisense/sdk-data';
+import { JaqlDataSourceForDto, MetadataItem } from '@sisense/sdk-data';
 import type { DashboardByIdConfig } from '../../domains/dashboarding';
 import { DashboardProps } from '../../domains/dashboarding/types.js';
 import { ExecutePivotQueryParams, ExecuteQueryParams } from '../../domains/query-execution/index.js';
@@ -319,17 +319,6 @@ export type NlqTranslationInput<DataType, ContextType> = {
     data: DataType;
     context: ContextType;
 };
-/**
- * Response JSON generated by the new NLQ API.
- *
- * @internal
- */
-export type NlqResponseJSON = {
-    dimensions: JSONArray;
-    measures: JSONArray;
-    filters: JSONArray;
-    highlights?: JSONArray;
-};
 /**
  * Data schema context for translation
  *
@@ -342,21 +331,16 @@ export interface DataSchemaContext {
     tables: NormalizedTable[];
 }
 /**
- * Query input for translation
- *
- * @internal
- */
-export type QueryInput = NlqTranslationInput<NlqResponseJSON, DataSchemaContext>;
-/**
- * Context information for error generation
+ * Context used when building translation errors (before message is attached).
  *
  * @internal
  */
 export type NlqTranslationErrorContext = {
-    /** The category of the query/chart element that failed (dimensions, measures, filters, highlights, dataOptions, chartType, styleOptions) */
-    category: 'dimensions' | 'measures' | 'filters' | 'highlights' | 'dataOptions' | 'chartType' | 'styleOptions';
-    /** The index of the element within its category array, or axis key for dataOptions (e.g. "category", "value") */
-    index: number | string;
+    /**
+     * Structural location in the JSON being translated, using pathPrefix notation.
+     * e.g. "widgets[0].dataOptions.category[0]" or "filters[0]"
+     */
+    path: string;
     /** The complete original input that caused the error */
     input: unknown;
 };

package/dist/packages/sdk-ui/src/modules/analytics-composer/widget/chart-options/get-widget-options.d.ts

@@ -15,6 +15,18 @@ export declare const getChartRecommendationsOrDefault: (response: ExpandedQueryM
  * @internal
  */
 export declare const getChartDataOptions: (metadataItems: MetadataItem[], chartFamily: string, axesMapping: AxesMapping) => ChartDataOptions;
+/**
+ * Minimal chart style overrides for consumers that persist widget props without merged SDK defaults.
+ * Compose merges these with per-chart defaults at render time (`extendStyleOptionsWithDefaults`).
+ *
+ * This function is used by buildChartEngine in sdk-ai-core
+ *
+ * @param chartType - chart type
+ * @param axesMapping - axes mapping
+ * @returns partial style options
+ * @internal
+ */
+export declare const getMinimalChartStyleOptions: (chartType: ChartType, axesMapping: AxesMapping) => Partial<ChartStyleOptions>;
 /**
  * Get chart style options for the chart widget.
  *

package/dist/packages/sdk-ui/src/props.d.ts

@@ -9,6 +9,7 @@ import { HighchartsOptions } from './domains/visualizations/core/chart-options-p
 import type { ChartWidgetProps } from './domains/widgets/components/chart-widget/types';
 import { FiltersMergeStrategy } from './domains/widgets/components/widget-by-id/types';
 import { type AppConfig } from './infra/app/types';
+import type { Module } from './infra/modules';
 import type { Plugin } from './infra/plugins/types';
 import { AreamapDataPoint, AreamapStyleOptions, AreaRangeStyleOptions, AreaStyleOptions, BoxplotDataPoint, BoxplotStyleOptions, CalendarHeatmapDataPoint, CalendarHeatmapStyleOptions, CartesianChartDataOptions, CategoricalChartDataOptions, ChartDataOptions, ChartDataPoints, ChartStyleOptions, ChartType, CustomDrilldownResult, DataPoint, DrilldownOptions, DrilldownSelection, FunnelStyleOptions, IndicatorDataPoint, IndicatorRenderOptions, IndicatorStyleOptions, LineStyleOptions, MenuAlignment, MenuItemSection, MenuPosition, PieStyleOptions, PivotTableDataPoint, PivotTableDrilldownOptions, PivotTableStyleOptions, PolarStyleOptions, RegularChartStyleOptions, RegularChartType, ScatterDataPoint, ScattermapDataPoint, ScattermapStyleOptions, ScatterStyleOptions, StackableStyleOptions, StreamgraphStyleOptions, SunburstStyleOptions, TableStyleOptions, TabularChartStyleOptions, TextWidgetDataPoint, ThemeConfig, ThemeOid, ThemeSettings, TreemapStyleOptions, WidgetByIdStyleOptions } from './types';
 export type { TabberButtonsWidgetProps } from './domains/widgets/components/tabber-buttons-widget/types';
@@ -167,6 +168,14 @@ export interface SisenseContextProviderProps {
      * @internal
      */
     plugins?: Plugin[];
+    /**
+     * Array of modules to register.
+     *
+     * @category Sisense App
+     *
+     * @alpha
+     */
+    modules?: Module[];
 }
 /**
  * Props for {@link ExecuteQuery} component.
@@ -622,6 +631,9 @@ export interface BaseChartProps extends BaseChartEventProps {
      * NOTE that the filter dimensions used in highlights must match those defined in the
      * `dataOptions` of the chart. Otherwise, the filters will be applied as regular slice filters.
      *
+     * NOTE that highlight filters in the "Include all" state are silently omitted from the
+     * query. To clear a highlight, remove it from the array.
+     *
      * (1) Array of {@link Filter} returned from filter factory functions, such as
      * {@link @sisense/sdk-data!filterFactory.greaterThan | `greaterThan()`} and {@link @sisense/sdk-data!filterFactory.members | `members()`}.
      *
@@ -971,7 +983,10 @@ export interface PivotTableProps {
      */
     filters?: Filter[] | FilterRelations;
     /**
-     * Filters that will highlight query results
+     * Filters that will highlight query results.
+     *
+     * NOTE that highlight filters in the "Include all" state are silently omitted from the
+     * query. To clear a highlight, remove it from the array.
      *
      * @category Data
      */
@@ -1094,7 +1109,10 @@ export interface WidgetByIdProps extends Omit<ChartWidgetProps, 'dataSource' | '
      */
     filters?: Filter[];
     /**
-     * Highlight filters that will highlight results that pass filter criteria
+     * Highlight filters that will highlight results that pass filter criteria.
+     *
+     * NOTE that highlight filters in the "Include all" state are silently omitted from the
+     * query. To clear a highlight, remove it from the array.
      *
      * @category Data
      */

package/dist/packages/sdk-ui/src/public-api/alpha.d.ts

@@ -9,4 +9,7 @@ export type { ThemeConfig } from '../types';
 export { type TranslationDictionary, PACKAGE_NAMESPACE as translationNamespace, } from '../infra/translation/resources';
 export { CascadingFilterTile, type CascadingFilterTileProps, } from '../domains/filters/components/cascading-filter-tile';
 export { CustomFilterTile, type CustomFilterTileProps, } from '../domains/filters/components/custom-filter-tile';
+export { useSyncedState, type UseSyncedStateOptions } from '../shared/hooks/use-synced-state';
 export { isIndicatorRenderOptions, isHighchartsOptions, type HighchartsOptions, type CalendarHeatmapChartEventProps, } from '../props';
+export type { Module, ModuleRequirement } from '../infra/modules/types.js';
+export { useModuleApiRegistry } from '../infra/modules/modules-context.js';

package/dist/packages/sdk-ui/src/public-api/internal.d.ts

@@ -14,7 +14,7 @@ export { getWidgetModel } from '../domains/widgets/widget-model';
 export { getHierarchyModels } from '../domains/drilldown/hierarchy-model';
 export { getThemeSettingsByOid } from '../infra/themes/theme-loader';
 export { getDefaultThemeSettings } from '../infra/contexts/theme-provider/default-theme-settings';
-export { type CompleteThemeSettings } from '../types';
+export { type CompleteThemeSettingsInternal } from '../types';
 export { updateDrilldownSelections } from '../domains/drilldown/hooks/use-drilldown-core';
 export { getSelectionTitleMenuItem, getDrilldownMenuItems, } from '../domains/drilldown/hooks/use-drilldown';
 export { processDrilldownSelections } from '../domains/drilldown/hooks/use-drilldown-core';

package/dist/packages/sdk-ui/src/public-api/public.d.ts

@@ -61,7 +61,8 @@ export { type FilterVariant } from '../domains/filters/components/common/filter-
 export { useGetFilterMembers, type GetFilterMembersParams, type FilterMembersState, type FilterMembersLoadingState, type FilterMembersSuccessState, type FilterMembersErrorState, type GetFilterMembersResult, type GetFilterMembersData, } from '../domains/filters/hooks/use-get-filter-members';
 export { useGetSharedFormula, type GetSharedFormulaParams, type UseGetSharedFormulaParams, type SharedFormulaState, type SharedFormulaLoadingState, type SharedFormulaErrorState, type SharedFormulaSuccessState, } from '../domains/formulas';
 export { useGetDataSourceDimensions, type GetDataSourceDimensionsParams, type DataSourceDimensionsState, type DataSourceDimensionsLoadingState, type DataSourceDimensionsErrorState, type DataSourceDimensionsSuccessState, } from '../domains/data-browser/data-source-dimensional-model';
-export { ThemeProvider } from '../infra/contexts/theme-provider';
+export { ThemeProvider, useTheme } from '../infra/contexts/theme-provider';
+export type { CompleteThemeSettings } from '../types';
 export { LoadingOverlay, type LoadingOverlayProps } from '../shared/components/loading-overlay';
 export { ContextMenu } from '../shared/components/menu/context-menu/context-menu';
 /**
@@ -93,7 +94,9 @@ export * as dashboardModelTranslator from '../domains/dashboarding/dashboard-mod
 export * as dashboardHelpers from '../domains/dashboarding/dashboard-helpers';
 export type { EmptyObject } from '../shared/utils/utility-types';
 export { useFetch, type RequestConfig, type UseQueryResult } from '../shared/hooks/use-fetch';
-export type { StyledColumn, SeriesStyleOptions, StyledMeasureColumn, CartesianChartDataOptions, CategoricalChartDataOptions, IndicatorChartDataOptions, ScatterChartDataOptions, AreamapChartDataOptions, CalendarHeatmapChartDataOptions, TableDataOptions, TabularChartDataOptions, PivotTableDataOptions, ScattermapLocationLevel, ScattermapChartDataOptions, BoxWhiskerType, BoxplotChartDataOptions, BoxplotChartCustomDataOptions, AreaRangeMeasureColumn, RangeChartDataOptions, ChartDataOptions, RegularChartDataOptions, } from '../domains/visualizations/core/chart-data-options/types';
+export type { StyledColumn, SeriesStyleOptions, StyledMeasureColumn, CartesianChartDataOptions, CategoricalChartDataOptions, IndicatorChartDataOptions, ScatterChartDataOptions, AreamapChartDataOptions, CalendarHeatmapChartDataOptions, TableDataOptions, TabularChartDataOptions, PivotTableDataOptions, ScattermapLocationLevel, ScattermapChartDataOptions, BoxWhiskerType, BoxplotChartDataOptions, BoxplotChartCustomDataOptions, AreaRangeMeasureColumn, RangeChartDataOptions, ChartDataOptions, RegularChartDataOptions, CommonDataOptions, } from '../domains/visualizations/core/chart-data-options/types';
+export { formatNumber, formatDate, getDefaultDateFormat, formatDataSet } from '../infra/formatting';
+export type { FormatDateOptions, FormatDataSetOptions } from '../infra/formatting';
 export type { TabberButtonsWidgetProps, SisenseContextProviderProps, ExecuteQueryProps, ThemeProviderProps, BeforeRenderHandler, IndicatorBeforeRenderHandler, ChartDataPointsEventHandler, DataPointsEventHandler, DataPointEventHandler, ScatterDataPointEventHandler, ScatterDataPointsEventHandler, AreamapDataPointEventHandler, ScattermapDataPointEventHandler, BoxplotDataPointEventHandler, IndicatorDataPointEventHandler, CalendarHeatmapDataPointEventHandler, CalendarHeatmapDataPointsEventHandler, PivotTableDataPointEventHandler, ChartEventProps, ChartProps, AreaChartProps, StreamgraphChartProps, BarChartProps, ColumnChartProps, FunnelChartProps, LineChartProps, PieChartProps, PolarChartProps, IndicatorChartProps, TableProps, PivotTableProps, ScatterChartProps, WidgetByIdProps, ExecuteQueryByWidgetIdProps, TreemapChartProps, SunburstChartProps, BoxplotChartProps, ScattermapChartProps, AreamapChartProps, AreaRangeChartProps, ContextMenuProps, DrilldownBreadcrumbsProps, DrilldownWidgetConfig, DrilldownWidgetProps, CalendarHeatmapChartProps, } from '../props';
 export type { AutoZoomNavigatorScrollerLocation } from '../domains/widgets/components/widget-by-id/types';
 export type { SortDirection, PivotRowsSort, AppConfig, DateConfig, CalendarDayOfWeek, IndicatorComponents, ScatterMarkerSize, LegendPosition, Coordinates, TableColorOptions, IndicatorRenderOptions, GeoDataElement, RawGeoDataElement, CartesianChartType, CategoricalChartType, ScatterChartType, IndicatorChartType, BoxplotChartType, ScattermapChartType, AreamapChartType, CalendarHeatmapChartType, TableType, TableChartType, RangeChartType, TextStyle, DataColorCondition, ConditionalDataColorOptions, DataColorOptions, RangeDataColorOptions, UniformDataColorOptions, AreaSubtype, AreaRangeSubtype, LineSubtype, PieSubtype, PolarSubtype, StackableSubtype, BoxplotSubtype, MonthOfYear, DayOfWeek, DateLevel, TabberButtonsWidgetStyleOptions, TabberButtonsWidgetCustomOptions, Color, ColorPaletteTheme, Navigator, LineWidth, DashStyle, EndCapType, LineOptions, Markers, X2Title, SeriesLabelsTextStyle, SeriesLabelsBase, SeriesLabelsAligning, SeriesLabels, TotalLabelsTextStyle, TotalLabels, LegendTitleOptions, LegendItemsOptions, LegendSymbolsOptions, LegendOptions, Legend, Labels, AxisLabel, Convolution, DataLimits, LineStyleOptions, AreaRangeStyleOptions, AreaStyleOptions, StreamgraphStyleOptions, StackableStyleOptions, PiePercentageLabels, PieSeriesLabels, PieStyleOptions, FunnelSeriesLabels, FunnelStyleOptions, PolarStyleOptions, IndicatorStyleOptions, TableStyleOptions, TabularChartStyleOptions, PivotTableStyleOptions, NumericSimpleIndicatorStyleOptions, NumericBarIndicatorStyleOptions, GaugeIndicatorStyleOptions, ScatterSeriesLabels, ScatterStyleOptions, TreemapSeriesLabels, TreemapStyleOptions, SunburstSeriesLabelsBase, SunburstSeriesLabels, SunburstStyleOptions, BoxplotStyleOptions, AreamapType, AreamapStyleOptions, ScattermapMarkers, ScattermapStyleOptions, CalendarHeatmapCellLabels, CalendarHeatmapSubtype, CalendarHeatmapStyleOptions, CalendarHeatmapViewType, ChartStyleOptions, RegularChartStyleOptions, ValueToColorMap, MultiColumnValueToColorMap, ChartType, RegularChartType, SeriesChartType, DecimalScale, NumberFormatConfig, ThemeOid, ChartThemeSettings, AiChatThemeSettings, ThemeSettingsFontSource, ThemeSettingsFont, FontsLoaderSettings, TypographyThemeSettings, GeneralThemeSettings, SpaceSizes, RadiusSizes, ShadowsTypes, AlignmentTypes, WidgetThemeSettings, FilterThemeSettings, ThemeSettings, WidgetStyleOptions, WidgetContainerStyleOptions, WidgetByIdStyleOptions, ChartWidgetStyleOptions, PivotTableWidgetStyleOptions, TextWidgetStyleOptions, CustomWidgetStyleOptions, DrilldownOptions, PivotTableDrilldownOptions, PivotTableSelectableDrilldownOptions, PivotTableNonSelectableDrilldownOptions, DrilldownSelection, DataOptionLocation, ChartDataPoints, ChartDataPoint, DataPoint, DataPointEntry, BasicDataPointEntry, AttributeDataPointEntry, MeasureDataPointEntry, ScatterDataPoint, BoxplotDataPoint, IndicatorDataPoint, CalendarHeatmapDataPoint, PivotTableDataPoint, AreamapDataPoint, ScattermapDataPoint, CustomWidgetDataPoint, CustomWidgetDataPointEventHandler, CustomWidgetDataPointContextMenuHandler, CustomWidgetDataPointsEventHandler, CustomWidgetEventProps, AbstractDataPointWithEntries, MenuPosition, MenuItemSection, CustomDrilldownResult, LoadingIndicatorConfig, GenericDataOptions, NestedTranslationResources, CustomTranslationObject, TranslationConfig, } from '../types';

package/dist/packages/sdk-ui/src/public-api/sisense-internal.d.ts

@@ -14,13 +14,13 @@ export { createDataOptionsFromPanels } from '../domains/widgets/components/widge
 export { extractCombinedFilters } from '../domains/widgets/components/widget-by-id/translate-dashboard-filters';
 export { useThemeContext } from '../infra/contexts/theme-provider';
 export { useAppSettings } from '../shared/hooks/use-app-settings';
-export type { AppSettings } from '../infra/app/settings/settings';
+export type { AiFeatureFlags, AppSettings } from '../infra/app/settings/settings';
 export { QuotaNotification } from '../shared/components/quota-notification/quota-notification.js';
 export type { QuotaNotificationProps } from '../shared/components/quota-notification/quota-notification.js';
 export { useQuotaNotification } from '../shared/hooks/use-quota-notification.js';
 export type { QuotaNotificationOptions, QuotaApiResponse, QuotaState, } from '../shared/hooks/use-quota-notification.js';
 export type { Plugin } from '../infra/plugins/types.js';
-export type { WidgetPlugin, CustomVisualization, CustomVisualizationProps, CustomVisualizationStyleOptions, CustomVisualizationEventProps, CustomVisualizationDataPoint, CustomVisualizationDataPointEventHandler, CustomVisualizationDataPointContextMenuHandler, CustomVisualizationDataPointsEventHandler, DesignPanelProps, DesignPanel, } from '../infra/plugins/widget-plugins/types.js';
+export type { WidgetPlugin, CustomVisualization, CustomVisualizationProps, VisualizationStateUpdate, CustomVisualizationStyleOptions, CustomVisualizationEventProps, CustomVisualizationDataPoint, CustomVisualizationDataPointEventHandler, CustomVisualizationDataPointContextMenuHandler, CustomVisualizationDataPointsEventHandler, DesignPanelProps, DesignPanel, } from '../infra/plugins/widget-plugins/types.js';
 export { LoadingIndicator } from '../shared/components/loading-indicator.js';
 export { DataSchemaBrowser } from '../domains/data-browser/data-schema-browser/data-schema-browser.js';
 export { type NarrativeQueryParams } from '../domains/narrative/core/build-narrative-request.js';

package/dist/packages/sdk-ui/src/shared/components/loading-indicator.d.ts

@@ -1,4 +1,4 @@
-import { CompleteThemeSettings } from '../../types.js';
+import { CompleteThemeSettingsInternal } from '../../types.js';
 /**
  * Component that displays a loading indicator.
  *
@@ -12,6 +12,6 @@ import { CompleteThemeSettings } from '../../types.js';
  * @sisenseInternal
  */
 export declare const LoadingIndicator: ({ themeSettings, onCancel, }: {
-    themeSettings?: CompleteThemeSettings | undefined;
+    themeSettings?: CompleteThemeSettingsInternal | undefined;
     onCancel?: (() => void) | undefined;
 }) => import("react/jsx-runtime").JSX.Element;

package/dist/packages/sdk-ui/src/shared/components/loading-overlay.d.ts

@@ -25,5 +25,6 @@ export type LoadingOverlayProps = {
  *   <Chart {...chartOptions} />
  * </LoadingOverlay>
  * ```
+ * @group Primitives
  */
 export declare const LoadingOverlay: ({ isVisible, children }: LoadingOverlayProps) => import("react/jsx-runtime").JSX.Element;

package/dist/packages/sdk-ui/src/shared/hooks/use-element-height.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Observes an HTML element's height via `ResizeObserver` and reports the latest
+ * measured height in CSS pixels.
+ *
+ * Returns a callback ref to attach to the target element and the current height.
+ * Height is `0` while no element is attached. The observer is re-bound when the
+ * attached node changes and disconnected on unmount.
+ *
+ * @example
+ * ```tsx
+ * const { ref, height } = useElementHeight<HTMLDivElement>();
+ * return <div ref={ref}>{height}px</div>;
+ * ```
+ * @internal
+ */
+export declare function useElementHeight<T extends HTMLElement = HTMLElement>(): {
+    ref: (node: T | null) => void;
+    height: number;
+};

package/dist/packages/sdk-ui/src/shared/hooks/use-synced-state.d.ts

@@ -1,5 +1,10 @@
 import { Dispatch, SetStateAction } from 'react';
-type UseSyncedStateOptions<T> = {
+/**
+ * Options for {@link useSyncedState}.
+ *
+ * @alpha
+ */
+export type UseSyncedStateOptions<T> = {
     /**
      * A callback function that is triggered when the state is updated via the local setter,
      * but not through synchronization with `syncValue`.
@@ -14,6 +19,22 @@ type UseSyncedStateOptions<T> = {
 /**
  * A custom React hook that behaves like the regular `useState`, but also synchronizes the state
  * with an external `syncValue`.
+ *
+ * @param syncValue - The external value to synchronize with. When this value changes (as
+ *   determined by `syncCompareFn`), the local state is updated to match it.
+ * @param options - Optional configuration object.
+ * @param options.onLocalStateChange - Callback invoked whenever the local state is updated via
+ *   the returned setter (not triggered by external `syncValue` synchronization).
+ * @param options.syncCompareFn - Custom equality function used to detect changes in `syncValue`.
+ *   Defaults to a deep equality check via `isEqual` from lodash-es. See {@link UseSyncedStateOptions}.
+ * @returns A tuple of `[localState, setState]` — the current local state and a setter that
+ *   both updates state and fires `onLocalStateChange`.
+ * @example
+ * ```tsx
+ * const [localState, setLocalState] = useSyncedState(externalValue, {
+ *   onLocalStateChange: (s) => console.log('local update', s),
+ * });
+ * ```
+ * @alpha
  */
 export declare function useSyncedState<T>(syncValue: T, { onLocalStateChange, syncCompareFn }?: UseSyncedStateOptions<T>): [T, Dispatch<SetStateAction<T>>];
-export {};

package/dist/packages/sdk-ui/src/shared/utils/filter-relations.d.ts

@@ -9,6 +9,14 @@ export declare enum FiltersMergeStrategyEnum {
     CODE_ONLY = "codeOnly"
 }
 export type FiltersMergeStrategy = `${FiltersMergeStrategyEnum}`;
+/**
+ * Returns true if any node in the filter-relations tree uses an OR operator.
+ * Used to decide whether to show the AND/OR Formula tile — AND-only trees are the default
+ * behavior and don't warrant a visible indicator.
+ *
+ * @internal
+ */
+export declare function hasOrOperator(relations: FilterRelationsRules): boolean;
 /**
  * Textual representation of filter relations for debugging purposes.
  * Returns string like "(([Gender] AND [Country]) OR [Condition])".

package/dist/packages/sdk-ui/src/shared/utils/gradient.d.ts

@@ -178,6 +178,7 @@ export type GradientColor = LinearGradientColor | RadialGradientColor;
  *
  * @param value - The value to check
  * @returns True if the value is a linear gradient
+ * @group Styling
  */
 export declare const isLinearGradient: (value: any) => value is LinearGradientColor;
 /**
@@ -185,6 +186,7 @@ export declare const isLinearGradient: (value: any) => value is LinearGradientCo
  *
  * @param value - The value to check
  * @returns True if the value is a radial gradient
+ * @group Styling
  */
 export declare const isRadialGradient: (value: any) => value is RadialGradientColor;
 /**
@@ -192,6 +194,7 @@ export declare const isRadialGradient: (value: any) => value is RadialGradientCo
  *
  * @param value - The value to check
  * @returns True if the value is a gradient
+ * @group Styling
  */
 export declare const isGradient: (value: any) => value is GradientColor;
 /**
@@ -315,6 +318,7 @@ export declare const RadialGradientPresets: {
  *   ]
  * );
  * ```
+ * @group Styling
  */
 export declare const createLinearGradient: (direction: LinearGradientDirection, stops: readonly GradientStop[]) => LinearGradientColor;
 /**
@@ -334,6 +338,7 @@ export declare const createLinearGradient: (direction: LinearGradientDirection,
  *   ]
  * );
  * ```
+ * @group Styling
  */
 export declare const createRadialGradient: (center: RadialGradientConfig, stops: readonly GradientStop[]) => RadialGradientColor;
 /**

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

@@ -1965,11 +1965,227 @@ export interface ThemeSettings {
  *
  * @internal
  */
-export type CompleteThemeSettings = DeepRequired<Omit<ThemeSettings, 'typography'>> & {
+export type CompleteThemeSettingsInternal = DeepRequired<Omit<ThemeSettings, 'typography'>> & {
     typography: DeepRequired<Omit<TypographyThemeSettings, 'fontsLoader'>> & {
         fontsLoader?: FontsLoaderSettings;
     };
 };
+/**
+ * Resolved theme returned by {@link useTheme}.
+ *
+ * Contains all theme values after defaults are applied. Unlike {@link ThemeSettings}
+ * (where every field is optional), every field here is guaranteed to be present.
+ */
+export type CompleteThemeSettings = {
+    /** Chart theme settings */
+    chart: {
+        /** Text color */
+        textColor: string;
+        /** Secondary text color */
+        secondaryTextColor: string;
+        /** Background color */
+        backgroundColor: string;
+        /** Animation options */
+        animation: {
+            /** Chart initialization animation options */
+            init: {
+                /** Animation duration in milliseconds */
+                duration: number | 'auto';
+            };
+            /** Chart redraw animation options */
+            redraw: {
+                /** Animation duration in milliseconds */
+                duration: number | 'auto';
+            };
+        };
+    };
+    /** Collection of colors used to color various elements */
+    palette: {
+        /** Set of colors used to color chart elements */
+        variantColors: Color[];
+    };
+    /** Text theme settings */
+    typography: {
+        /** Font family name to style component text */
+        fontFamily: string;
+        /** Primary text color */
+        primaryTextColor: string;
+        /** Secondary text color */
+        secondaryTextColor: string;
+        /** Hyperlink color */
+        hyperlinkColor: string;
+        /** Hyperlink hover color */
+        hyperlinkHoverColor: string;
+        /** Settings for font loading */
+        fontsLoader?: FontsLoaderSettings;
+    };
+    /** General theme settings */
+    general: {
+        /** Main color used for various elements like primary buttons, switches, etc. */
+        brandColor: string;
+        /** Background color used for elements like tiles, etc. */
+        backgroundColor: string;
+        /** Text color for primary buttons */
+        primaryButtonTextColor: string;
+        /** Hover color for primary buttons */
+        primaryButtonHoverColor: string;
+    };
+    /** Widget theme settings */
+    widget: {
+        /** Space between widget container edge and the chart */
+        spaceAround: SpaceSizes;
+        /** Corner radius of the widget container */
+        cornerRadius: RadiusSizes;
+        /** Shadow level of the widget container */
+        shadow: ShadowsTypes;
+        /** Widget container border toggle */
+        border: boolean;
+        /** Widget container border color */
+        borderColor: string;
+        /** Widget header styles */
+        header: {
+            /** Header title text color */
+            titleTextColor: string;
+            /** Header title alignment */
+            titleAlignment: AlignmentTypes;
+            /** Header title font size */
+            titleFontSize: number;
+            /** Toggle of the divider line between widget header and chart */
+            dividerLine: boolean;
+            /** Divider line color */
+            dividerLineColor: string;
+            /** Header background color */
+            backgroundColor: string;
+        };
+    };
+    /** Filter theme settings */
+    filter: {
+        panel: {
+            /** Title color */
+            titleColor: string;
+            /** Background color */
+            backgroundColor: string;
+            /** Divider line color for the filter panel */
+            dividerLineColor: string;
+            /** Divider line width for the filter panel */
+            dividerLineWidth: number;
+        };
+    };
+    /** Theme settings specific to the AI Chatbot component */
+    aiChat: {
+        /** Background color of the chatbot */
+        backgroundColor: string;
+        /** Text color of the chatbot */
+        primaryTextColor: string;
+        /** Secondary text color of the chatbot */
+        secondaryTextColor: string;
+        /** Primary font size for text in the chatbot */
+        primaryFontSize: [fontSize: string, lineHeight: string];
+        /** Border of the chatbot */
+        border: false | string;
+        /** Border radius of the chatbot */
+        borderRadius: false | string;
+        /** Settings for the main chat body */
+        body: {
+            paddingLeft: string;
+            paddingRight: string;
+            paddingTop: string;
+            paddingBottom: string;
+            gapBetweenMessages: string;
+        };
+        /** Settings for the chat footer */
+        footer: {
+            paddingLeft: string;
+            paddingRight: string;
+            paddingTop: string;
+            paddingBottom: string;
+        };
+        /** Settings for user chat messages */
+        userMessages: {
+            backgroundColor: string;
+        };
+        /** Settings for system chat messages */
+        systemMessages: {
+            backgroundColor: string;
+        };
+        /** Settings for the chatbot input */
+        input: {
+            backgroundColor: string;
+            focus: {
+                outlineColor: string;
+            };
+        };
+        /** Settings for the chatbot header */
+        header: {
+            backgroundColor: string;
+            textColor: string;
+        };
+        /** Settings for chatbot dropup */
+        dropup: {
+            backgroundColor: string;
+            boxShadow: string;
+            borderRadius: string;
+            headers: {
+                textColor: string;
+                hover: {
+                    backgroundColor: string;
+                };
+            };
+            items: {
+                textColor: string;
+                hover: {
+                    backgroundColor: string;
+                };
+            };
+        };
+        /** Settings for the chatbot suggestions */
+        suggestions: {
+            textColor: string;
+            backgroundColor: string;
+            border: string;
+            borderGradient: [string, string] | null;
+            borderRadius: string;
+            hover: {
+                textColor: string;
+                backgroundColor: string;
+            };
+            loadingGradient: [string, string];
+            gap: string;
+        };
+        /** Settings for the chatbot clickable messages */
+        clickableMessages: {
+            textColor: string;
+            backgroundColor: string;
+            border: false | string;
+            borderGradient: [string, string] | null;
+            hover: {
+                textColor: string;
+                backgroundColor: string;
+            };
+        };
+        /** Settings for the data topics screen */
+        dataTopics: {
+            backgroundColor: string;
+            items: {
+                textColor: string;
+                backgroundColor: string;
+            };
+        };
+        /** Settings for the chatbot icons */
+        icons: {
+            color: string;
+            feedbackIcons: {
+                hoverColor: string;
+            };
+        };
+        /** Settings for the chatbot tooltips */
+        tooltips: {
+            backgroundColor: string;
+            textColor: string;
+            boxShadow: string;
+        };
+    };
+};
 /** @alpha */
 export type ThemeConfig = {
     cssSelectorPrefix?: {