@sisense/sdk-ui 2.27.0 → 2.28.0

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

@@ -1,6 +1,9 @@
 import { type Arg, type ArgValue, Attribute, Filter, FilterRelations, type FunctionCall, JaqlDataSourceForDto, JSONArray, Measure, PivotGrandTotals } from '@sisense/sdk-data';
+import type { CommonFiltersOptions } from '../../../domains/dashboarding/common-filters/types.js';
+import type { DashboardConfig, DashboardLayoutOptions, DashboardStyleOptions } from '../../../domains/dashboarding/types.js';
 import { CategoryStyle, SeriesStyle, ValueStyle } from '../../../domains/visualizations/core/chart-data-options/types.js';
-import type { PivotTableStyleOptions } from '../../../types.js';
+import type { WidgetConfig, WidgetType } from '../../../domains/widgets/components/widget/types.js';
+import type { CustomWidgetStyleOptions, PivotTableStyleOptions, TextWidgetStyleOptions } from '../../../types.js';
 import { DataSchemaContext, NlqTranslationInput } from '../types.js';
 import type { SchemaIndex } from './shared/utils/schema-index.js';
 /**
@@ -49,8 +52,12 @@ export type NodeInput = NlqTranslationInput<FunctionCall, FunctionContext>;
 export type ArgInput = NlqTranslationInput<Arg, ArgContext>;
 /**
  * Custom processor function signature.
+ *
+ * Implementations must not mutate `processedArgs`. Returns the argument list to pass to
+ * `executeFunction`—typically the same array reference when only validating, or a new array when
+ * normalizing or replacing nested values.
  */
-export type CustomFunctionProcessor = (processedArgs: ProcessedArg[], context: FunctionContext) => void;
+export type CustomFunctionProcessor = (processedArgs: ProcessedArg[], context: FunctionContext) => ProcessedArg[];
 /**
  * Type guard: value is a non-null object (Record<string, unknown>).
  * @internal
@@ -209,3 +216,125 @@ export interface PivotTableJSON {
  * @internal
  */
 export type PivotTableInput = NlqTranslationInput<PivotTableJSON, DataSchemaContext>;
+/**
+ * Mirrors `WithCommonWidgetProps` for the JSON layer
+ */
+type WithCommonWidgetJSON<Base, Type extends WidgetType> = Base & {
+    widgetType: Type;
+    readonly id: string;
+};
+/**
+ * Data source in NLQ JSON — title only. Full JAQL details live in {@link DataSchemaContext}.
+ *
+ * @internal
+ */
+export type DataSourceJSON = string;
+/**
+ * JSON representation of a chart widget
+ *
+ * @internal
+ */
+export type ChartWidgetJSON = ChartJSON & {
+    title?: string;
+    description?: string;
+    dataSource?: DataSourceJSON;
+    config?: WidgetConfig;
+    highlightSelectionDisabled?: boolean;
+};
+/**
+ * JSON representation of a pivot table widget.
+ *
+ * @internal
+ */
+export type PivotTableWidgetJSON = PivotTableJSON & {
+    title?: string;
+    description?: string;
+    dataSource?: DataSourceJSON;
+    config?: WidgetConfig;
+};
+/**
+ * JSON representation of a text widget
+ *
+ * @internal
+ */
+export type TextWidgetJSON = {
+    styleOptions: TextWidgetStyleOptions;
+    config?: WidgetConfig;
+};
+/**
+ * JSON representation of a custom/plugin widget payload.
+ * `dataOptions` is passed through as opaque JSON — `GenericDataOptions` cannot be reliably
+ * round-tripped without custom-widget-specific schema knowledge.
+ * Only `filters` and `highlights` are translated; all other fields are pass-through.
+ * `widgetType` and `id` are added on `WidgetJSON` via `WithCommonWidgetJSON`.
+ *
+ * @internal
+ */
+export type CustomWidgetJSON = {
+    customWidgetType: string;
+    title?: string;
+    description?: string;
+    dataSource?: DataSourceJSON;
+    config?: WidgetConfig;
+    filters?: FunctionCall[];
+    highlights?: FunctionCall[];
+    /** Opaque pass-through — GenericDataOptions serialized as plain JSON */
+    dataOptions?: Record<string, unknown>;
+    styleOptions?: CustomWidgetStyleOptions;
+    customOptions?: Record<string, unknown>;
+};
+/**
+ * Dashboard-level options for a specific widget in NLQ JSON.
+ * Excludes non-JSON-safe fields such as `jtdConfig` (Map / Filter objects).
+ *
+ * @internal
+ */
+export type SpecificWidgetOptionsJSON = {
+    filtersOptions?: CommonFiltersOptions;
+    partialDtoOptions?: {
+        options?: Record<string, unknown>;
+        style?: Record<string, unknown>;
+    };
+};
+/**
+ * Widget options map for NLQ dashboard JSON.
+ *
+ * @internal
+ */
+export type WidgetsOptionsJSON = Record<string, SpecificWidgetOptionsJSON>;
+/**
+ * Discriminated union of all NLQ widget JSON representations.
+ * Mirrors the `WidgetProps` discriminated union in serializable JSON form.
+ *
+ * @internal
+ */
+export type WidgetJSON = WithCommonWidgetJSON<ChartWidgetJSON, 'chart'> | WithCommonWidgetJSON<PivotTableWidgetJSON, 'pivot'> | WithCommonWidgetJSON<TextWidgetJSON, 'text'> | WithCommonWidgetJSON<CustomWidgetJSON, 'custom'>;
+/**
+ * JSON representation of a dashboard.
+ *
+ * @internal
+ */
+export interface DashboardJSON {
+    id?: string;
+    title?: string;
+    filters?: FunctionCall[];
+    widgets: WidgetJSON[];
+    layoutOptions?: DashboardLayoutOptions;
+    config?: DashboardConfig;
+    /** Data source title only — schema details live in {@link DataSchemaContext}. */
+    defaultDataSource?: DataSourceJSON;
+    styleOptions?: DashboardStyleOptions;
+    widgetsOptions?: WidgetsOptionsJSON;
+}
+/**
+ * Input type for widget translation (JSON → CSDK).
+ *
+ * @internal
+ */
+export type WidgetInput = NlqTranslationInput<WidgetJSON, DataSchemaContext>;
+/**
+ * Input type for dashboard translation (JSON → CSDK).
+ *
+ * @internal
+ */
+export type DashboardInput = NlqTranslationInput<DashboardJSON, DataSchemaContext>;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/widget/helpers/index.d.ts

@@ -0,0 +1,6 @@
+export { translateCustomWidgetFiltersFromJSON } from './translate-custom-widget-filters-from-json.js';
+export { translateEnvelopeWidgetFromJSON } from './translate-envelope-widget-from-json.js';
+export { toChartWidgetProps, toPivotTableWidgetProps } from './to-widget-props.js';
+export type { WidgetMeta } from './to-widget-props.js';
+export { validateWidgetType } from './validate-widget-json.js';
+export { hasRequiredWidgetId, missingWidgetIdError } from './widget-id.js';

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/widget/helpers/to-widget-props.d.ts

@@ -0,0 +1,27 @@
+import type { WidgetConfig, WidgetProps } from '../../../../../domains/widgets/components/widget/types.js';
+import type { ChartProps, PivotTableProps } from '../../../../../props.js';
+import type { DataSourceJSON } from '../../types.js';
+export type WidgetMeta = {
+    readonly id: string;
+    readonly title?: string;
+    readonly description?: string;
+    readonly dataSource?: DataSourceJSON;
+    readonly config?: WidgetConfig;
+    readonly highlightSelectionDisabled?: boolean;
+};
+/**
+ * Maps chart component props (with `dataSet`) to chart widget props (with `dataSource`).
+ *
+ * @internal
+ */
+export declare const toChartWidgetProps: (chartProps: ChartProps, meta: WidgetMeta) => Extract<WidgetProps, {
+    widgetType: 'chart';
+}>;
+/**
+ * Maps pivot table component props (with `dataSet`) to pivot widget props (with `dataSource`).
+ *
+ * @internal
+ */
+export declare const toPivotTableWidgetProps: (pivotProps: PivotTableProps, meta: WidgetMeta) => Extract<WidgetProps, {
+    widgetType: 'pivot';
+}>;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/widget/helpers/translate-custom-widget-filters-from-json.d.ts

@@ -0,0 +1,12 @@
+import type { Filter, FilterRelations, FunctionCall } from '@sisense/sdk-data';
+import type { DataSchemaContext, NlqTranslationResult } from '../../../types.js';
+export type CustomWidgetFiltersTranslation = {
+    readonly filters?: Filter[] | FilterRelations;
+    readonly highlights?: Filter[];
+};
+/**
+ * Translates custom-widget filters and highlights from NLQ JSON to CSDK filters.
+ *
+ * @internal
+ */
+export declare const translateCustomWidgetFiltersFromJSON: (filters: FunctionCall[] | undefined, highlights: FunctionCall[] | undefined, context: DataSchemaContext) => NlqTranslationResult<CustomWidgetFiltersTranslation>;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/widget/helpers/translate-envelope-widget-from-json.d.ts

@@ -0,0 +1,20 @@
+import type { WidgetConfig } from '../../../../../domains/widgets/components/widget/types.js';
+import type { DataSchemaContext, NlqTranslationInput, NlqTranslationResult } from '../../../types.js';
+import type { DataSourceJSON } from '../../types.js';
+import type { WidgetMeta } from './to-widget-props.js';
+type WidgetEnvelopeJSON = {
+    readonly id: string;
+    readonly title?: string;
+    readonly description?: string;
+    readonly dataSource?: DataSourceJSON;
+    readonly config?: WidgetConfig;
+    readonly highlightSelectionDisabled?: boolean;
+};
+/**
+ * Strips widget envelope fields and delegates to a chart/pivot sub-translator,
+ * then maps component props to widget props with metadata.
+ *
+ * @internal
+ */
+export declare const translateEnvelopeWidgetFromJSON: <TWidgetJSON extends WidgetEnvelopeJSON, TPayload, TComponentProps, TWidgetProps>(widgetJSON: TWidgetJSON, context: DataSchemaContext, translate: (input: NlqTranslationInput<TPayload, DataSchemaContext>) => NlqTranslationResult<TComponentProps>, toWidgetProps: (props: TComponentProps, meta: WidgetMeta) => TWidgetProps) => NlqTranslationResult<TWidgetProps>;
+export {};

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/widget/helpers/validate-widget-json.d.ts

@@ -0,0 +1,8 @@
+import type { NlqTranslationError } from '../../../types.js';
+/**
+ * Validates that widget JSON includes a supported `widgetType`.
+ *
+ * @param rawInput - Raw widget JSON object
+ * @returns Validation error, or `null` when `widgetType` is present and valid
+ */
+export declare function validateWidgetType(rawInput: unknown): NlqTranslationError | null;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/widget/helpers/widget-id.d.ts

@@ -0,0 +1,17 @@
+import type { NlqTranslationError } from '../../../types.js';
+/**
+ * Builds a translation error when widget JSON is missing a required `id`.
+ *
+ * @internal
+ */
+export declare const missingWidgetIdError: (input: unknown) => NlqTranslationError;
+/**
+ * Narrows widget JSON to require a present `id`.
+ *
+ * @internal
+ */
+export declare const hasRequiredWidgetId: <T extends {
+    id?: string | undefined;
+}>(widget: T) => widget is T & {
+    id: string;
+};

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/widget/translate-widget-from-json.d.ts

@@ -0,0 +1,19 @@
+import type { WidgetProps } from '../../../../domains/widgets/components/widget/types.js';
+import type { NlqTranslationResult } from '../../types.js';
+import type { WidgetInput } from '../types.js';
+/**
+ * Translates NLQ WidgetJSON format to CSDK widget props.
+ * Direction: JSON → CSDK
+ *
+ * Dispatches to the appropriate sub-translator based on `widgetType`:
+ * - `'chart'` → `translateChartFromJSON`
+ * - `'pivot'` → `translatePivotTableFromJSON`
+ * - `'text'` → pass-through (no data translation)
+ * - `'custom'` → filters/highlights translated; dataOptions passed through as opaque JSON
+ *
+ *
+ * @param input - WidgetInput containing widgetJSON and data schema context
+ * @returns NlqTranslationResult with WidgetProps or errors
+ * @internal
+ */
+export declare const translateWidgetFromJSON: (input: WidgetInput) => NlqTranslationResult<WidgetProps>;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/widget/translate-widget-to-json.d.ts

@@ -0,0 +1,18 @@
+import type { WidgetProps } from '../../../../domains/widgets/components/widget/types.js';
+import type { NlqTranslationResult } from '../../types.js';
+import type { WidgetJSON } from '../types.js';
+/**
+ * Translates CSDK widget props to NLQ WidgetJSON format.
+ * Direction: CSDK → JSON
+ *
+ * Dispatches to the appropriate sub-translator based on `widgetType`:
+ * - `'chart'` → `translateChartToJSON`
+ * - `'pivot'` → `translatePivotTableToJSON`
+ * - `'text'` → pass-through of styleOptions
+ * - `'custom'` → filters/highlights translated; dataOptions passed through as opaque JSON
+ *
+ * @param widgetProps - Widget props with widgetType discriminant (id required)
+ * @returns NlqTranslationResult with WidgetJSON or errors
+ * @internal
+ */
+export declare const translateWidgetToJSON: (widgetProps: WidgetProps) => NlqTranslationResult<WidgetJSON>;

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

@@ -348,15 +348,16 @@ export interface DataSchemaContext {
  */
 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

@@ -622,6 +622,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 +974,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 +1100,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/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';
 /**

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

@@ -14,7 +14,7 @@ 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';

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/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?: {