@sisense/sdk-ui 2.27.0 → 2.28.0

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

@@ -10,7 +10,7 @@ import { WidgetDto } from '../../../../domains/widgets/components/widget-by-id/t
 import { WidgetProps } from '../../../../domains/widgets/components/widget/types';
 import { AppSettings } from '../../../../infra/app/settings/settings.js';
 import { ChartProps, PivotTableProps, TableProps } from '../../../../props';
-import { CompleteThemeSettings } from '../../../../types.js';
+import { CompleteThemeSettingsInternal } from '../../../../types.js';
 import { WidgetModel } from '../widget-model';
 /**
  * Translates a {@link WidgetModel} to the parameters for executing a query for the widget.
@@ -160,7 +160,7 @@ export declare function toJtdConfig(widgetModel: WidgetModel): JumpToDashboardCo
  * @returns The widget model
  * @internal
  */
-export declare function fromWidgetDto(widgetDto: WidgetDto, themeSettings?: CompleteThemeSettings, appSettings?: AppSettings): WidgetModel;
+export declare function fromWidgetDto(widgetDto: WidgetDto, themeSettings?: CompleteThemeSettingsInternal, appSettings?: AppSettings): WidgetModel;
 /**
  * Creates a {@link WidgetModel} from a {@link ChartWidgetProps}.
  *
@@ -212,4 +212,4 @@ export declare function fromWidgetProps(widgetProps: WidgetProps): WidgetModel;
  *
  * @sisenseInternal
  */
-export declare function toWidgetDto(widgetModel: WidgetModel, dataSource?: JaqlDataSourceForDto, themeSettings?: CompleteThemeSettings, appSettings?: AppSettings): WidgetDto;
+export declare function toWidgetDto(widgetModel: WidgetModel, dataSource?: JaqlDataSourceForDto, themeSettings?: CompleteThemeSettingsInternal, appSettings?: AppSettings): WidgetDto;

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

@@ -123,6 +123,13 @@ export declare class RestApi {
         count?: number;
         searchValue?: string;
     }) => Promise<DataSourceField[] | undefined>;
+    /**
+     * Export JAQL query results as an XLSX file (binary response).
+     *
+     * @param body - JSON payload for the JAQL export API
+     * @returns XLSX file as a {@link Blob}
+     */
+    exportJaqlToXlsx: (body: object) => Promise<Blob | undefined>;
 }
 export declare const useRestApi: () => {
     restApi: RestApi | undefined;

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

@@ -2,18 +2,35 @@ import { HttpClient } from '@sisense/sdk-rest-client';
 import { AppConfig, ThemeSettings } from '../../../types';
 import { LegacyDesignSettings } from '../../themes/legacy-design-settings.js';
 import { FeatureMap } from './types/features.js';
+/**
+ * Known AI feature flags exposed on {@link AppSettings} `ai.featureFlags`.
+ * Add a flag here when you want first-class typing/autocomplete for it; otherwise
+ * it still surfaces via the index signature on {@link AiFeatureFlags}.
+ */
+type KnownAiFeatureFlags = {
+    completionV2: boolean;
+    naturalResponseEnabled: boolean;
+    nlqV3Enabled: boolean;
+    queryDefinition: boolean;
+};
+/**
+ * Loose, forward-compatible shape of `ai.featureFlags`. Known flags are strongly typed
+ * (see {@link KnownAiFeatureFlags}); arbitrary string-keyed flags are type-allowed
+ * for forward compatibility (unknown keys are readable as `boolean | undefined`)
+ * without requiring a CSDK type bump.
+ *
+ * @sisenseInternal
+ */
+export type AiFeatureFlags = KnownAiFeatureFlags & {
+    [flag: string]: boolean | undefined;
+};
 /**
  * AI-related slice derived from globals (`serverFeatures` + deployment props),
  * aligned with admin UI paths such as `ai.featureFlags.*`, `ai.featureModelType`,
  * `ai.quotaNotification`, and `ai.aiStudio.*`.
  */
 type AiSettingsSlice = {
-    featureFlags: {
-        completionV2: boolean;
-        naturalResponseEnabled: boolean;
-        nlqV3Enabled: boolean;
-        queryDefinition: boolean;
-    };
+    featureFlags: AiFeatureFlags;
     /**
      * Only when `serverFeatures.aiAssistant` exists.
      * If the block is present but omits this field, defaults to `customer_byok`.
@@ -112,6 +129,8 @@ type ServerSettings = {
         lastName?: string;
         /** From `api/globals` `user.email`. */
         email?: string;
+        /** From `api/globals` `user.baseRoleName`. */
+        baseRoleName?: string;
     };
     /**
      * Raw Fusion `designSettings` from `api/globals` (before palette / theme conversion).

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

@@ -1,8 +1,8 @@
 import { PropsWithChildren } from 'react';
-import { CompleteThemeSettings, CustomContextProviderProps } from '../../../types';
+import { CompleteThemeSettingsInternal, CustomContextProviderProps } from '../../../types';
 /** @internal */
 export type CustomThemeProviderProps = CustomContextProviderProps<{
-    themeSettings: CompleteThemeSettings;
+    themeSettings: CompleteThemeSettingsInternal;
     skipTracking?: boolean;
 }>;
 /**

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/default-theme-settings.d.ts

@@ -1,4 +1,4 @@
-import { CompleteThemeSettings } from '../../../types';
+import { CompleteThemeSettingsInternal } from '../../../types';
 export declare const DEFAULT_DIVIDER_COLOR = "#F2F2F2";
 export declare const DEFAULT_DIVIDER_WIDTH = 4;
 export declare const DEFAULT_DASHBOARD_BORDER_COLOR = "#D5D5D5";
@@ -19,4 +19,4 @@ export declare const DEFAULT_HYPERLINK_HOVER_COLOR = "#1FCCF3";
  * @returns Theme settings object
  * @internal
  */
-export declare const getDefaultThemeSettings: (isDarkMode?: boolean) => CompleteThemeSettings;
+export declare const getDefaultThemeSettings: (isDarkMode?: boolean) => CompleteThemeSettingsInternal;

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/index.d.ts

@@ -1,2 +1,3 @@
 export * from './theme-provider';
 export * from './theme-context';
+export * from './use-theme';

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/theme-context.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="react" />
-import { CompleteThemeSettings, ThemeConfig } from '../../../types';
+import { CompleteThemeSettingsInternal, ThemeConfig } from '../../../types';
 export declare const ThemeContext: import("react").Context<{
-    themeSettings: CompleteThemeSettings;
+    themeSettings: CompleteThemeSettingsInternal;
     config?: ThemeConfig | undefined;
 }>;
 /**
@@ -12,6 +12,6 @@ export declare const ThemeContext: import("react").Context<{
  * @sisenseInternal
  */
 export declare const useThemeContext: () => {
-    themeSettings: CompleteThemeSettings;
+    themeSettings: CompleteThemeSettingsInternal;
     config?: ThemeConfig | undefined;
 };

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/types.d.ts

@@ -1,7 +1,7 @@
-import { CompleteThemeSettings } from '../../../types';
+import { CompleteThemeSettingsInternal } from '../../../types';
 /**
  * Themable interface for styled components that require theme settings.
  */
 export type Themable = {
-    theme: CompleteThemeSettings;
+    theme: CompleteThemeSettingsInternal;
 };

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/use-theme-settings.d.ts

@@ -1,4 +1,4 @@
-import { CompleteThemeSettings, ThemeOid, ThemeSettings } from '../../../types';
+import { CompleteThemeSettingsInternal, ThemeOid, ThemeSettings } from '../../../types';
 /**
  * Returns the theme settings for the given theme OID or theme settings and error if it happened.
  *
@@ -9,4 +9,4 @@ import { CompleteThemeSettings, ThemeOid, ThemeSettings } from '../../../types';
  * @param userTheme Theme OID or theme settings object
  * @returns Theme settings and error if it happened
  */
-export declare function useThemeSettings(userTheme?: ThemeOid | ThemeSettings): [CompleteThemeSettings, null] | [null, Error];
+export declare function useThemeSettings(userTheme?: ThemeOid | ThemeSettings): [CompleteThemeSettingsInternal, null] | [null, Error];

package/dist/packages/sdk-ui/src/infra/contexts/theme-provider/use-theme.d.ts

@@ -0,0 +1,14 @@
+import { CompleteThemeSettings } from '../../../types';
+/**
+ * Returns the resolved theme from the nearest {@link ThemeProvider}.
+ * Falls back to the default theme when no provider is present.
+ *
+ * @example
+ * ```tsx
+ * const { palette, typography, widget } = useTheme();
+ * ```
+ *
+ * @returns Resolved {@link CompleteThemeSettings}
+ * @group Contexts
+ */
+export declare const useTheme: () => CompleteThemeSettings;

package/dist/packages/sdk-ui/src/infra/themes/legacy-design-settings.d.ts

@@ -1,6 +1,6 @@
-import { CompleteThemeSettings, ThemeOid } from '../../types.js';
+import { CompleteThemeSettingsInternal, ThemeOid } from '../../types.js';
 /**
- * Legacy analog of CompleteThemeSettings used in Sisense UI.
+ * Legacy analog of CompleteThemeSettingsInternal used in Sisense UI.
  */
 export type LegacyDesignSettings = {
     oid: ThemeOid;
@@ -88,11 +88,11 @@ export declare const LEGACY_DESIGN_TYPES: {
     dark: string;
 };
 /**
- * Converts legacy (used in Sisense UI) design settings and it's palette object to CompleteThemeSettings.
+ * Converts legacy (used in Sisense UI) design settings and its palette object to CompleteThemeSettingsInternal.
  *
  * @param legacyDesignSettings - legacy design settings.
  * @param legacyPalette - legacy palette object.
  * @returns
  */
-export declare function convertToThemeSettings(legacyDesignSettings: LegacyDesignSettings, legacyPalette: LegacyPalette, domainUrl: string): CompleteThemeSettings;
+export declare function convertToThemeSettings(legacyDesignSettings: LegacyDesignSettings, legacyPalette: LegacyPalette, domainUrl: string): CompleteThemeSettingsInternal;
 export declare function getPaletteName(legacyDesignSettings: LegacyDesignSettings): string;

package/dist/packages/sdk-ui/src/infra/themes/theme-loader.d.ts

@@ -1,13 +1,13 @@
 import type { HttpClient } from '@sisense/sdk-rest-client';
-import type { CompleteThemeSettings, ThemeOid } from '../../types';
+import type { CompleteThemeSettingsInternal, ThemeOid } from '../../types';
 import { type LegacyPalette } from './legacy-design-settings';
 /**
- * Fetches theme settings from the Sisense instance and converts them to CompleteThemeSettings.
+ * Fetches theme settings from the Sisense instance and converts them to CompleteThemeSettingsInternal.
  *
  * @param themeOid - Theme oid.
  * @param httpClient - Sisense REST API client.
- * @returns CompleteThemeSettings from server.
+ * @returns CompleteThemeSettingsInternal from server.
  * @internal
  */
-export declare function getThemeSettingsByOid(themeOid: ThemeOid, httpClient: Pick<HttpClient, 'get' | 'url'>): Promise<CompleteThemeSettings>;
+export declare function getThemeSettingsByOid(themeOid: ThemeOid, httpClient: Pick<HttpClient, 'get' | 'url'>): Promise<CompleteThemeSettingsInternal>;
 export declare function getLegacyPalette(paletteName: string, httpClient: Pick<HttpClient, 'get'>): Promise<LegacyPalette>;

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/de-de.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/en-us.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/es-ar.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/es-es.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/fr-fr.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/it-it.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/ja-jp.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/ko-kr.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/nl-nl.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/pt-br.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/ru-ru.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/tr-tr.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/__external__/zh-cn.d.ts

@@ -225,6 +225,9 @@ declare const _default: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/en.d.ts

@@ -222,6 +222,9 @@ export declare const translation: {
             distributeEqualWidth: string;
             download: string;
             csvFile: string;
+            excelFile: string;
+            repeatRowsRecommended: string;
+            mergeRows: string;
         };
     };
     customWidgets: {

package/dist/packages/sdk-ui/src/infra/translation/resources/index.d.ts

@@ -232,6 +232,9 @@ export declare const resources: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {
@@ -681,6 +684,9 @@ export declare const resources: {
                 distributeEqualWidth: string;
                 download: string;
                 csvFile: string;
+                excelFile: string;
+                repeatRowsRecommended: string;
+                mergeRows: string;
             };
         };
         customWidgets: {

package/dist/packages/sdk-ui/src/modules/ai/ai-disclaimer.d.ts

@@ -1,4 +1,4 @@
-import { CompleteThemeSettings } from '../..';
+import { CompleteThemeSettingsInternal } from '../..';
 export default function AiDisclaimer({ theme }: {
-    theme: CompleteThemeSettings;
+    theme: CompleteThemeSettingsInternal;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,17 @@
+import { DashboardProps } from '../../../../domains/dashboarding/types.js';
+import type { NlqTranslationResult } from '../../types.js';
+import type { DashboardInput } from '../types.js';
+/**
+ * Translates NLQ DashboardJSON format to CSDK DashboardProps.
+ * Direction: JSON → CSDK
+ *
+ * Translates each widget using `translateWidgetFromJSON` (which requires each widget JSON to
+ * have an `id`). Dashboard-level filters are translated using the shared filter translator.
+ *
+ * Translation fails if any widget or filter translation fails.
+ *
+ * @param input - DashboardInput containing dashboardJSON and data schema context
+ * @returns NlqTranslationResult with DashboardProps or errors
+ * @internal
+ */
+export declare const translateDashboardFromJSON: (input: DashboardInput) => NlqTranslationResult<DashboardProps>;

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

@@ -0,0 +1,15 @@
+import { DashboardProps } from '../../../../domains/dashboarding/types.js';
+import type { NlqTranslationResult } from '../../types.js';
+import type { DashboardJSON } from '../types.js';
+/**
+ * Translates CSDK DashboardProps to NLQ DashboardJSON format.
+ * Direction: CSDK → JSON
+ *
+ * Translates each widget using `translateWidgetToJSON` and dashboard-level filters using
+ * the shared filter translator. Translation fails if any widget or filter translation fails.
+ *
+ * @param dashboardProps - Dashboard props to serialize
+ * @returns NlqTranslationResult with DashboardJSON or errors
+ * @internal
+ */
+export declare const translateDashboardToJSON: (dashboardProps: DashboardProps) => NlqTranslationResult<DashboardJSON>;

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

@@ -4,5 +4,9 @@ export * from './chart/translate-chart-from-json.js';
 export * from './chart/translate-chart-to-json.js';
 export * from './pivot-table/translate-pivot-table-from-json.js';
 export * from './pivot-table/translate-pivot-table-to-json.js';
+export * from './widget/translate-widget-from-json.js';
+export * from './widget/translate-widget-to-json.js';
+export * from './dashboard/translate-dashboard-from-json.js';
+export * from './dashboard/translate-dashboard-to-json.js';
 export * from './query/translate-query-to-jaql.js';
-export type { ChartJSON, DataOptionsJSON, ChartInput, PivotTableJSON, PivotTableDataOptionsJSON, PivotTableInput, } from './types.js';
+export type { ChartJSON, DataOptionsJSON, ChartInput, DataSourceJSON, PivotTableJSON, PivotTableDataOptionsJSON, PivotTableInput, ChartWidgetJSON, PivotTableWidgetJSON, TextWidgetJSON, CustomWidgetJSON, WidgetJSON, WidgetInput, SpecificWidgetOptionsJSON, WidgetsOptionsJSON, DashboardJSON, DashboardInput, } from './types.js';

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/data-options/adapters.d.ts

@@ -13,7 +13,4 @@ export type AxisType = 'dimension' | 'measure';
 export declare function adaptDimensionsToStyledColumn(items: DimensionTranslationItem[]): (Attribute | StyledColumn)[];
 export declare function adaptMeasuresToStyledMeasureColumn(items: MeasureTranslationItem[]): (Measure | StyledMeasureColumn)[];
 export declare function toJSONArray(value: DimensionItemJSON | DimensionItemJSON[] | MeasureItemJSON | MeasureItemJSON[]): JSONArray;
-/**
- * Maps inner translation errors to dataOptions axis context.
- */
 export declare function withAxisContext(axisKey: string): (e: NlqTranslationError) => NlqTranslationError;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/expression/custom-formula/process-custom-formula.d.ts

@@ -12,6 +12,7 @@ import { FunctionContext, ProcessedArg } from '../../../types.js';
  *
  * @param processedArgs - [title: string, formula: string, context: Record<string, unknown>, format?: string, description?: string]
  * @param context - Processing context with error prefix and other metadata
+ * @returns New args array with `processedContext` at index 2 (does not mutate `processedArgs`)
  * @throws Error with descriptive message if validation fails
  */
-export declare function processCustomFormula(processedArgs: ProcessedArg[], context: FunctionContext): void;
+export declare function processCustomFormula(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/expression/factory-function-processors.d.ts

@@ -13,7 +13,6 @@ import { CustomFunctionProcessor } from '../../types.js';
  * ```typescript
  * // Adding a new custom processor
  * 'measureFactory.rank': processRankingParameters,
- * 'filterFactory.dateRange': processDateRangeLogic,
  * ```
  */
 export declare const FUNCTION_PROCESSORS: Record<string, CustomFunctionProcessor>;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/expression/filter-processors.d.ts

@@ -5,33 +5,37 @@ import { FunctionContext, ProcessedArg } from '../../types.js';
  *
  * @param processedArgs - [attribute, value, config?]
  * @param context - Processing context with error prefix and other metadata
+ * @returns Same `processedArgs` reference when validation succeeds
  * @throws Error with descriptive message if validation fails
  */
-export declare function processStringOrNumericFilter(processedArgs: ProcessedArg[], context: FunctionContext): void;
+export declare function processStringOrNumericFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];
 /**
  * Processes filters that only accept numeric values
  * Used by: greaterThan, lessThan, between, etc.
  *
  * @param processedArgs - [attribute, value, config?]
  * @param context - Processing context with error prefix and other metadata
+ * @returns Same `processedArgs` reference when validation succeeds
  * @throws Error with descriptive message if validation fails
  */
-export declare function processNumericFilter(processedArgs: ProcessedArg[], context: FunctionContext): void;
+export declare function processNumericFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];
 /**
  * Processes filters that only accept string values
  * Used by: contains, startsWith, endsWith, like, etc.
  *
  * @param processedArgs - [attribute, value, config?]
  * @param context - Processing context with error prefix and other metadata
+ * @returns Same `processedArgs` reference when validation succeeds
  * @throws Error with descriptive message if validation fails
  */
-export declare function processStringFilter(processedArgs: ProcessedArg[], context: FunctionContext): void;
+export declare function processStringFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];
 /**
  * Processes exclude filter to validate that it only accepts members filters
  * Used by: exclude
  *
  * @param processedArgs - [filter, inputFilter?, config?]
  * @param context - Processing context with error prefix and other metadata
+ * @returns Same `processedArgs` reference when validation succeeds
  * @throws Error with descriptive message if validation fails
  */
-export declare function processExcludeFilter(processedArgs: ProcessedArg[], context: FunctionContext): void;
+export declare function processExcludeFilter(processedArgs: ProcessedArg[], context: FunctionContext): ProcessedArg[];

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/utils/error-path.d.ts

@@ -0,0 +1,37 @@
+import type { NlqTranslationError } from '../../../types.js';
+/**
+ * Builds a path string for a dataOptions field.
+ *
+ * @internal
+ */
+export declare function dataOptionsPath(axisKey: string | number, itemIndex?: number): string;
+/**
+ * Joins path segments using pathPrefix notation (e.g. "widgets[0].dataOptions.category[0]").
+ *
+ * @internal
+ */
+export declare function joinPathStrings(prefix: string, suffix?: string): string;
+/**
+ * Prefixes an error path with a structural segment.
+ *
+ * @internal
+ */
+export declare function prefixPath(prefix: string): (error: NlqTranslationError) => NlqTranslationError;
+/**
+ * Prefixes path with widgets[index] for dashboard-level widget errors.
+ *
+ * @internal
+ */
+export declare function withWidgetsArrayPath(widgetIndex: number): (error: NlqTranslationError) => NlqTranslationError;
+/**
+ * Prefixes filter errors with filters[index] at dashboard level.
+ *
+ * @internal
+ */
+export declare function withFilterPath(filterIndex: number): (error: NlqTranslationError) => NlqTranslationError;
+/**
+ * Maps errors from a translation result through a mapper.
+ *
+ * @internal
+ */
+export declare function mapTranslationErrors(errors: readonly NlqTranslationError[], mapError: (error: NlqTranslationError) => NlqTranslationError): NlqTranslationError[];

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/shared/utils/translation-helpers.d.ts

@@ -3,17 +3,49 @@
  *
  * @internal
  */
-import { JSONValue } from '@sisense/sdk-data';
+import type { DataSource, JSONObject } from '@sisense/sdk-data';
+import type { WidgetsOptions } from '../../../../../domains/dashboarding/dashboard-model/types.js';
 import type { NlqTranslationError, NlqTranslationResult } from '../../../types.js';
+import type { DataSourceJSON, WidgetsOptionsJSON } from '../../types.js';
+type WithOptionalToJSON = {
+    toJSON?: () => JSONObject;
+};
+/**
+ * Returns a JSON-friendly snapshot for translation error reporting.
+ * Uses `toJSON()` when present (CSDK Attribute/Measure); otherwise returns the value as-is.
+ *
+ * @internal
+ */
+/**
+ * Serializes a CSDK data source to NLQ JSON (title string only).
+ *
+ * @param dataSource - Widget or dashboard data source
+ * @returns Data source title for JSON output
+ * @internal
+ */
+export declare function translateDataSourceToJSON(dataSource: DataSource): DataSourceJSON;
+/**
+ * Extracts JSON-serializable widget options from dashboard `widgetsOptions`.
+ * Omits `jtdConfig` and other non-JSON-safe fields.
+ *
+ * @param widgetsOptions - Dashboard widget options map
+ * @returns Widget options safe for NLQ JSON, or `undefined` when empty
+ * @internal
+ */
+export declare function translateWidgetsOptionsToJSON(widgetsOptions: WidgetsOptions): WidgetsOptionsJSON | undefined;
+export declare function toNlqErrorInput(value: WithOptionalToJSON | unknown): unknown;
 /**
  * Recursively strips [[delimiters]] from all strings in a JSON structure.
  * Transforms "DM.[[Commerce Sales]].[[Order Date]]" → "DM.Commerce Sales.Order Date"
  *
- * @param value - The JSON value to process
+ * Accepts NLQ output shapes (e.g. ChartJSON) that are JSON-serializable at runtime but are not
+ * assignable to sdk-data `JSONValue` because of `Record<string, unknown>` style fields.
+ *
+ * @param value - The value to process
  * @returns The value with all [[delimiters]] stripped from strings
  * @internal
  */
-export declare function stripDelimitersFromJson<T extends JSONValue>(value: T): T;
+export declare function stripDelimitersFromJson<T>(value: T): T;
 export declare function getSuccessData<T>(result: NlqTranslationResult<T>): T;
 export declare function getErrors<T>(result: NlqTranslationResult<T>): string[];
 /**
@@ -29,3 +61,4 @@ export declare function getErrors<T>(result: NlqTranslationResult<T>): string[];
  * @internal
  */
 export declare function collectTranslationErrors<T>(translateFn: () => NlqTranslationResult<T>, errors: NlqTranslationError[], mapError?: (e: NlqTranslationError) => NlqTranslationError): T | null;
+export {};