@sisense/sdk-ui 2.21.0 → 2.23.0

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

@@ -221,12 +221,14 @@ export declare const resources: {
             };
         };
         widgetHeader: {
+            addTitle: string;
             info: {
                 details: string;
                 tooltip: string;
             };
             menu: {
                 deleteWidget: string;
+                renameWidget: string;
                 distributeEqualWidth: string;
             };
         };
@@ -277,6 +279,12 @@ export declare const resources: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -357,6 +365,9 @@ export declare const resources: {
             configureFilter: string;
             noResults: string;
             searchPlaceholder: string;
+            more: string;
+            filter: string;
+            addMeasure: string;
         };
         pivotTable: {
             grandTotal: string;
@@ -396,6 +407,26 @@ export declare const resources: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
+        measures: {
+            countShort: string;
+            countDistinct: string;
+            count: string;
+            average: string;
+            sum: string;
+            min: string;
+            max: string;
+            stdev: string;
+            median: string;
+            variance: string;
+        };
     };
     'en-US': {
         errors: {
@@ -610,12 +641,14 @@ export declare const resources: {
             };
         };
         widgetHeader: {
+            addTitle: string;
             info: {
                 details: string;
                 tooltip: string;
             };
             menu: {
                 deleteWidget: string;
+                renameWidget: string;
                 distributeEqualWidth: string;
             };
         };
@@ -666,6 +699,12 @@ export declare const resources: {
                 unknownResponse: string;
                 invalidInput: string;
                 noAvailableDataTopics: string;
+                failedToFetchCreditBalance: string;
+            };
+            quota: {
+                exceededErrorTitle: string;
+                exceededErrorDescription: string;
+                warningDescription: string;
             };
         };
         attribute: {
@@ -746,6 +785,9 @@ export declare const resources: {
             configureFilter: string;
             noResults: string;
             searchPlaceholder: string;
+            more: string;
+            filter: string;
+            addMeasure: string;
         };
         pivotTable: {
             grandTotal: string;
@@ -785,5 +827,25 @@ export declare const resources: {
                 nextGroup: string;
             };
         };
+        filterTile: {
+            menu: {
+                lock: string;
+                unlock: string;
+                lockGroup: string;
+                unlockGroup: string;
+            };
+        };
+        measures: {
+            countShort: string;
+            countDistinct: string;
+            count: string;
+            average: string;
+            sum: string;
+            min: string;
+            max: string;
+            stdev: string;
+            median: string;
+            variance: string;
+        };
     };
 };

package/dist/packages/sdk-ui/src/modules/ai/api/chat-rest-api.d.ts

@@ -6,7 +6,8 @@ export declare class ChatRestApi {
     private readonly volatile;
     private httpClient;
     private readonly isUnifiedNarrationEnabled;
-    constructor(httpClient: HttpClient, volatile?: boolean, isUnifiedNarrationEnabled?: boolean);
+    private readonly isSisenseAiEnabled;
+    constructor(httpClient: HttpClient, volatile?: boolean, isUnifiedNarrationEnabled?: boolean, isSisenseAiEnabled?: boolean);
     getChatContexts: () => Promise<ChatContext[]>;
     private getNlgInsights;
     private getQueryRecommendations;

package/dist/packages/sdk-ui/src/modules/ai/api/narration-endpoints.d.ts

@@ -1,7 +1,7 @@
 import type { HttpClient } from '@sisense/sdk-rest-client';
 import type { GetNlgInsightsRequest, GetNlgInsightsResponse } from './types.js';
 /** Unified narrative endpoint. Try first; fall back to legacy on 404. */
-export declare const UNIFIED_NARRATION_ENDPOINT = "api/v2/ai/widget/narrative";
+export declare const UNIFIED_NARRATION_ENDPOINT = "api/v2/ai/narrative";
 /** Legacy endpoint (used when unified narrative returns 404). */
 export declare const LEGACY_NARRATION_ENDPOINT = "api/v2/ai/nlg/queryResult";
 /**
@@ -10,6 +10,7 @@ export declare const LEGACY_NARRATION_ENDPOINT = "api/v2/ai/nlg/queryResult";
  */
 export type GetNarrationsOptions = {
     isUnifiedNarrationEnabled?: boolean;
+    isSisenseAiEnabled?: boolean;
 };
 /**
  * Fetches narrations. Single place for endpoint logic: isUnifiedNarrationEnabled === false → legacy only;

package/dist/packages/sdk-ui/src/modules/ai/get-nlg-insights-from-widget.d.ts

@@ -12,6 +12,7 @@ export interface GetNlgInsightsFromWidgetOptions {
     verbosity?: 'Low' | 'High';
     /** When false, legacy narration endpoint only; when true or undefined, try unified then fallback. From props.isUnifiedNarrationEnabled. */
     isUnifiedNarrationEnabled?: boolean;
+    isSisenseAiEnabled?: boolean;
 }
 /**
  * Pure function that fetches NLG insights from WidgetProps.

package/dist/packages/sdk-ui/src/modules/ai/use-get-nlq-result.d.ts

@@ -94,6 +94,7 @@ export declare const useGetNlqResultInternal: (params: UseGetNlqResultParams) =>
  * ```
  * @returns NLQ load state that contains the status of the execution, the result (data) as WidgetProps
  * @group Generative AI
+ *
  * @beta
  */
 export declare const useGetNlqResult: (params: UseGetNlqResultParams) => UseGetNlqResultState;

package/dist/packages/sdk-ui/src/modules/ai/use-get-query-recommendations.d.ts

@@ -79,6 +79,7 @@ export declare const useGetQueryRecommendationsInternal: (params: UseGetQueryRec
  * ```
  * @returns An array of objects, each containing recommended question text and its corresponding `widgetProps`
  * @group Generative AI
+ *
  * @beta
  */
 export declare const useGetQueryRecommendations: (params: UseGetQueryRecommendationsParams) => UseGetQueryRecommendationsState;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/chart/helpers/axis-type-detection.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Determines whether a dataOptions axis contains dimensions or measures.
+ * Uses schema metadata and content-based detection for mixed axes.
+ *
+ * @internal
+ */
+import type { DimensionItemJSON, MeasureItemJSON } from '../../types.js';
+/**
+ * Determines if an axis contains dimensions (vs measures).
+ * Uses axis name and type detection to make the determination.
+ *
+ * @param axisKey - The dataOptions axis key (e.g., 'category', 'value', 'x')
+ * @param axisValue - The axis value (dimension or measure item(s))
+ * @param chartType - Optional chart type for chart-specific overrides
+ * @returns true if the axis contains dimensions, false if measures
+ */
+export declare function isDimensionAxisType(axisKey: string, axisValue: DimensionItemJSON | DimensionItemJSON[] | MeasureItemJSON | MeasureItemJSON[], chartType?: string): boolean;

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/chart/helpers/chart-type-schemas.d.ts

@@ -0,0 +1,37 @@
+import { ChartType } from '../../../../../types.js';
+/** Returns a defensive copy of the set of valid chart types. */
+export declare function getValidChartTypes(): Set<string>;
+/** Frozen array of chart types valid for NLQ translation (excludes 'image') */
+export declare const VALID_CHART_TYPES_ARRAY: readonly string[];
+/** Top-level ChartJSON keys */
+export declare const CHART_JSON_TOP_LEVEL_KEYS: readonly ["chartType", "dataOptions", "styleOptions", "filters", "highlights"];
+/** Valid dataOptions axis keys (union of all chart types) */
+export declare const VALID_DATA_OPTIONS_KEYS: Set<string>;
+/** Per-chart-type axes metadata: valid axes and required axes */
+export declare const CHART_TYPE_AXES_METADATA: Record<string, {
+    validAxes: Set<string>;
+    requiredAxes: string[];
+}>;
+/** Known dimension axes (used for axis type detection) */
+export declare const DIMENSION_AXES: Set<string>;
+/** Known measure axes (used for axis type detection) */
+export declare const MEASURE_AXES: Set<string>;
+/**
+ * Returns valid/required axes metadata for a chart type.
+ * Returns defensive copies so callers cannot mutate shared structures.
+ *
+ * @param chartType - The chart type to look up
+ * @returns Metadata (with new Set and array copies) or undefined if chart type is unknown
+ */
+export declare function getChartTypeMetadata(chartType: string): {
+    validAxes: Set<string>;
+    requiredAxes: readonly string[];
+} | undefined;
+/**
+ * Type guard: value is a valid ChartType for NLQ translation.
+ */
+export declare function isValidChartType(value: unknown): value is ChartType;
+/**
+ * Checks if a key is a valid dataOptions axis.
+ */
+export declare function isValidDataOptionsKey(key: string): boolean;

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

@@ -0,0 +1,9 @@
+/**
+ * Chart JSON processing: schema metadata, validation, and translation.
+ *
+ * @internal
+ */
+export { CHART_TYPE_AXES_METADATA, DIMENSION_AXES, getChartTypeMetadata, getValidChartTypes, isValidChartType, isValidDataOptionsKey, MEASURE_AXES, VALID_CHART_TYPES_ARRAY, VALID_DATA_OPTIONS_KEYS, } from './chart-type-schemas.js';
+export { isDimensionAxisType } from './axis-type-detection.js';
+export { validateChartJSONStructure } from './validate-chart-json.js';
+export { translateDataOptionsFromJSON } from './translate-data-options.js';

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/chart/helpers/translate-data-options.d.ts

@@ -0,0 +1,9 @@
+import type { ChartDataOptions } from '../../../../../types.js';
+import { NlqTranslationError } from '../../../types.js';
+import type { DataOptionsJSON, InternalDataSchemaContext } from '../../types.js';
+/**
+ * Translates dataOptions from JSON to CSDK format.
+ * Delegates to dimension/measure translators for each axis.
+ * Collects errors via collectTranslationErrors; never throws.
+ */
+export declare function translateDataOptionsFromJSON(dataOptionsJSON: DataOptionsJSON | undefined, context: InternalDataSchemaContext, translationErrors: NlqTranslationError[]): ChartDataOptions | null;

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

@@ -0,0 +1,19 @@
+/**
+ * Validates top-level ChartJSON structure.
+ * Detects typos in prop names and invalid chartType values.
+ *
+ * @internal
+ */
+import { NlqTranslationError } from '../../../types.js';
+import type { ChartJSON } from '../../types.js';
+/**
+ * Validates top-level ChartJSON structure.
+ * Returns normalized ChartJSON and any structural errors.
+ *
+ * @param rawInput - Raw input (object) to validate
+ * @returns Normalized ChartJSON and array of validation errors
+ */
+export declare function validateChartJSONStructure(rawInput: unknown): {
+    normalized: ChartJSON;
+    errors: NlqTranslationError[];
+};

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

@@ -0,0 +1,42 @@
+import { ChartProps } from '../../../../props.js';
+import { NlqTranslationResult } from '../../types.js';
+import type { ChartInput } from '../types.js';
+/**
+ * Translates NLQ ChartJSON format to CSDK chart props.
+ * Direction: JSON → CSDK
+ *
+ * Translates chart JSON generated by the NLQ API to CSDK ChartProps object.
+ *
+ * @example
+ * Input:
+ * {
+ *   chartType: 'column',
+ *   dataOptions: {
+ *     category: ['DM.Commerce.Date.Years'],
+ *     value: [
+ *       { function: 'measureFactory.sum', args: ['DM.Commerce.Revenue', 'Total Revenue'] }
+ *     ],
+ *     breakBy: [{ column: 'DM.Commerce.Gender', sortType: 'sortAsc' }]
+ *   },
+ *   filters: [
+ *     { function: 'filterFactory.members', args: ['DM.Commerce.Date.Years', ['2024-01-01T00:00:00']] }
+ *   ]
+ * }
+ *
+ * Output:
+ * {
+ *   chartType: 'column',
+ *   dataSet: { ... },
+ *   dataOptions: {
+ *     category: [Attribute(...), ...],
+ *     value: [Measure(...), ...],
+ *     breakBy: [Attribute(...), ...]
+ *   },
+ *   filters: [Filter(...), ...]
+ * }
+ *
+ * @param input - ChartInput object containing chartJSON and data schema context
+ * @returns NlqTranslationResult with ChartProps or errors
+ * @internal
+ */
+export declare const translateChartFromJSON: (input: ChartInput) => NlqTranslationResult<ChartProps>;

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

@@ -0,0 +1,41 @@
+import { ChartProps } from '../../../../props.js';
+import { NlqTranslationResult } from '../../types.js';
+import { ChartJSON } from '../types.js';
+/**
+ * Translates CSDK chart props to NLQ ChartJSON format.
+ * Direction: CSDK → JSON
+ *
+ * Translates CSDK ChartProps object to chart JSON format compatible with NLQ API.
+ *
+ * @example
+ * Input:
+ * {
+ *   chartType: 'column',
+ *   dataOptions: {
+ *     category: [Attribute(...)],
+ *     value: [Measure(...)],
+ *     breakBy: [Attribute(...)]
+ *   },
+ *   filters: [Filter(...)]
+ * }
+ *
+ * Output:
+ * {
+ *   chartType: 'column',
+ *   dataOptions: {
+ *     category: ['DM.Commerce.Date.Years'],
+ *     value: [
+ *       { function: 'measureFactory.sum', args: ['DM.Commerce.Revenue', 'Total Revenue'] }
+ *     ],
+ *     breakBy: [{ column: 'DM.Commerce.Gender', sortType: 'sortAsc' }]
+ *   },
+ *   filters: [
+ *     { function: 'filterFactory.members', args: ['DM.Commerce.Date.Years', ['2024-01-01T00:00:00']] }
+ *   ]
+ * }
+ *
+ * @param chartProps - Partial chart props with chartType and dataOptions
+ * @returns NlqTranslationResult with ChartJSON or errors
+ * @internal
+ */
+export declare const translateChartToJSON: (chartProps: Partial<ChartProps>) => NlqTranslationResult<ChartJSON>;

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

@@ -0,0 +1,11 @@
+import { NlqTranslationResult } from '../../../types.js';
+import { DimensionsInput, DimensionTranslationItem } from '../../types.js';
+/**
+ * Translates an array of JSON dimension items (strings or StyledColumnJSON) to enriched format.
+ *
+ * Direction: JSON → CSDK
+ *
+ * @param input - DimensionsInput object
+ * @returns NlqTranslationResult<DimensionTranslationItem[]>
+ */
+export declare const translateDimensionsFromJSON: (input: DimensionsInput) => NlqTranslationResult<DimensionTranslationItem[]>;

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

@@ -0,0 +1,22 @@
+import { Attribute, JSONArray } from '@sisense/sdk-data';
+import type { SortDirection } from '@sisense/sdk-data';
+import { NlqTranslationResult } from '../../../types.js';
+/** Runtime StyledColumn: wrapper with column and optional CategoryStyle (from chart dataOptions) */
+type StyledColumn = {
+    column: Attribute;
+    sortType?: SortDirection;
+    [key: string]: unknown;
+};
+/**
+ * Translates CSDK Attribute or StyledColumn array to NLQ JSON format (string or StyledColumnJSON array).
+ *
+ * When an attribute has sort applied (via getSort() or StyledColumn.sortType), or when StyledColumn
+ * has other style props (dateFormat, numberFormatConfig, etc.), outputs StyledColumnJSON with all
+ * properties; otherwise outputs composeCode string.
+ *
+ * @param dimensions - Array of CSDK Attribute or StyledColumn objects
+ * @returns NlqTranslationResult<JSONArray> - JSON array output for NLQ dimensions
+ * @internal
+ */
+export declare function translateDimensionsToJSON(dimensions: (Attribute | StyledColumn)[]): NlqTranslationResult<JSONArray>;
+export {};

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{translate-filters-from-json.d.ts → constructs/filters/translate-filters-from-json.d.ts}

@@ -1,6 +1,6 @@
 import { Filter, FilterRelations } from '@sisense/sdk-data';
-import { NlqTranslationResult } from '../types.js';
-import { FiltersFunctionCallInput, FiltersInput, HighlightsFunctionCallInput, HighlightsInput } from './types.js';
+import { NlqTranslationResult } from '../../../types.js';
+import { FiltersFunctionCallInput, FiltersInput, HighlightsFunctionCallInput, HighlightsInput } from '../../types.js';
 /**
  * Translate an array of JSON objects to filters
  *

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{translate-filters-to-json.d.ts → constructs/filters/translate-filters-to-json.d.ts}

@@ -1,5 +1,5 @@
 import { Filter, FilterRelations, JSONArray } from '@sisense/sdk-data';
-import { NlqTranslationResult } from '../types.js';
+import { NlqTranslationResult } from '../../../types.js';
 /**
  * Translates CSDK Filter array or FilterRelations to NLQ JSON format (FunctionCall array).
  *

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{translate-measures-from-json.d.ts → constructs/measures/translate-measures-from-json.d.ts}

@@ -1,6 +1,6 @@
 import { Measure } from '@sisense/sdk-data';
-import { NlqTranslationErrorContext, NlqTranslationResult } from '../types.js';
-import { FunctionCall, InternalDataSchemaContext, MeasuresInput } from './types.js';
+import { NlqTranslationErrorContext, NlqTranslationResult } from '../../../types.js';
+import { FunctionCall, InternalDataSchemaContext, MeasuresInput, MeasureTranslationItem } from '../../types.js';
 /**
  * Translate a single function call to a measure.
  *
@@ -8,7 +8,7 @@ import { FunctionCall, InternalDataSchemaContext, MeasuresInput } from './types.
  */
 export declare const translateMeasureFromJSONFunctionCall: (functionCall: FunctionCall, context: InternalDataSchemaContext, errorContext: NlqTranslationErrorContext) => NlqTranslationResult<Measure>;
 /**
- * Translates an array of JSON measure items (FunctionCall or StyledMeasureColumnJSON) to measures.
+ * Translates an array of JSON measure items (FunctionCall or StyledMeasureColumnJSON) to enriched format.
  *
  * Direction: JSON → CSDK
  *
@@ -19,4 +19,4 @@ export declare const translateMeasureFromJSONFunctionCall: (functionCall: Functi
  * ]
  * @internal
  */
-export declare const translateMeasuresFromJSON: (input: MeasuresInput) => NlqTranslationResult<Measure[]>;
+export declare const translateMeasuresFromJSON: (input: MeasuresInput) => NlqTranslationResult<MeasureTranslationItem[]>;

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

@@ -0,0 +1,22 @@
+import { JSONArray, Measure } from '@sisense/sdk-data';
+import type { SortDirection } from '@sisense/sdk-data';
+import { NlqTranslationResult } from '../../../types.js';
+/** Runtime StyledMeasureColumn: wrapper with column and optional style (from chart dataOptions) */
+type StyledMeasureColumn = {
+    column: Measure;
+    sortType?: SortDirection;
+    [key: string]: unknown;
+};
+/**
+ * Translates CSDK Measure or StyledMeasureColumn array to NLQ JSON format (FunctionCall or StyledMeasureColumnJSON array).
+ *
+ * When a measure has sort applied (via getSort() or StyledMeasureColumn.sortType), or when StyledMeasureColumn
+ * has other style props (trend, forecast, numberFormatConfig, etc.), outputs StyledMeasureColumnJSON;
+ * otherwise outputs the parsed FunctionCall.
+ *
+ * @param measures - Array of CSDK Measure or StyledMeasureColumn objects
+ * @returns NlqTranslationResult<JSONArray> - JSON array output for NLQ measures
+ * @internal
+ */
+export declare function translateMeasuresToJSON(measures: (Measure | StyledMeasureColumn)[]): NlqTranslationResult<JSONArray>;
+export {};

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

@@ -1,3 +1,8 @@
-export * from './translate-query-from-json.js';
-export * from './translate-query-to-json.js';
-export * from './translate-query-to-jaql.js';
+export * from './query/translate-query-from-json.js';
+export * from './query/translate-query-to-json.js';
+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 './query/translate-query-to-jaql.js';
+export type { ChartJSON, DataOptionsJSON, ChartInput, PivotTableJSON, PivotTableDataOptionsJSON, PivotTableInput, } from './types.js';

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

@@ -0,0 +1,7 @@
+/**
+ * Pivot table JSON processing: validation and translation.
+ *
+ * @internal
+ */
+export { validatePivotTableJSONStructure } from './validate-pivot-table-json.js';
+export { translatePivotTableDataOptionsFromJSON } from './translate-data-options.js';

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/pivot-table/helpers/translate-data-options.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Translates pivot table dataOptions from JSON to CSDK format.
+ * Uses shared translateSingleAxisFromJSON for rows, columns, values.
+ *
+ * @internal
+ */
+import type { PivotTableDataOptions } from '../../../../../domains/visualizations/core/chart-data-options/types.js';
+import { NlqTranslationError } from '../../../types.js';
+import type { InternalDataSchemaContext, PivotTableDataOptionsJSON } from '../../types.js';
+/**
+ * Translates pivot table dataOptions from JSON to CSDK format.
+ * Pivot has fixed axes: rows/columns (dimensions), values (measures), grandTotals (passthrough).
+ */
+export declare function translatePivotTableDataOptionsFromJSON(dataOptionsJSON: PivotTableDataOptionsJSON | undefined, context: InternalDataSchemaContext, translationErrors: NlqTranslationError[]): PivotTableDataOptions | null;

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

@@ -0,0 +1,19 @@
+/**
+ * Validates top-level PivotTableJSON structure.
+ * Detects typos in prop names and invalid dataOptions structure.
+ *
+ * @internal
+ */
+import { NlqTranslationError } from '../../../types.js';
+import type { PivotTableJSON } from '../../types.js';
+/**
+ * Validates top-level PivotTableJSON structure.
+ * Returns normalized PivotTableJSON and any structural errors.
+ *
+ * @param rawInput - Raw input (object) to validate
+ * @returns Normalized PivotTableJSON and array of validation errors
+ */
+export declare function validatePivotTableJSONStructure(rawInput: unknown): {
+    normalized: PivotTableJSON;
+    errors: NlqTranslationError[];
+};

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

@@ -0,0 +1,12 @@
+import { PivotTableProps } from '../../../../props.js';
+import { NlqTranslationResult } from '../../types.js';
+import type { PivotTableInput } from '../types.js';
+/**
+ * Translates NLQ PivotTableJSON format to CSDK pivot table props.
+ * Direction: JSON → CSDK
+ *
+ * @param input - PivotTableInput object containing pivotTableJSON and data schema context
+ * @returns NlqTranslationResult with PivotTableProps or errors
+ * @internal
+ */
+export declare const translatePivotTableFromJSON: (input: PivotTableInput) => NlqTranslationResult<PivotTableProps>;

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

@@ -0,0 +1,12 @@
+import { PivotTableProps } from '../../../../props.js';
+import { NlqTranslationResult } from '../../types.js';
+import type { PivotTableJSON } from '../types.js';
+/**
+ * Translates CSDK pivot table props to NLQ PivotTableJSON format.
+ * Direction: CSDK → JSON
+ *
+ * @param pivotTableProps - Partial pivot table props with dataOptions
+ * @returns NlqTranslationResult with PivotTableJSON or errors
+ * @internal
+ */
+export declare const translatePivotTableToJSON: (pivotTableProps: Partial<PivotTableProps>) => NlqTranslationResult<PivotTableJSON>;

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

@@ -0,0 +1,8 @@
+/**
+ * Name prefixes for trend and forecast measures in query JSON.
+ * Aligns with chart behavior so generated measure names are consistent.
+ *
+ * @internal
+ */
+export declare const TREND_PREFIX = "$trend";
+export declare const FORECAST_PREFIX = "$forecast";

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

@@ -1,6 +1,6 @@
-import { BaseQueryParams } from '../../../domains/query-execution/index.js';
-import { NlqTranslationResult } from '../types.js';
-import { QueryInput } from '../types.js';
+import { BaseQueryParams } from '../../../../domains/query-execution/index.js';
+import { NlqTranslationResult } from '../../types.js';
+import { QueryInput } from '../../types.js';
 /**
  * Translates NLQ JSON format to CSDK BaseQueryParams object.
  * Direction: JSON → CSDK

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{translate-query-to-jaql.d.ts → query/translate-query-to-jaql.d.ts}

@@ -1,6 +1,6 @@
 import { type DataSource } from '@sisense/sdk-data';
 import type { JaqlQueryPayload } from '@sisense/sdk-query-client';
-import { BaseQueryParams } from '../../../domains/query-execution/types.js';
+import { BaseQueryParams } from '../../../../domains/query-execution/types.js';
 /**
  * Converts BaseQueryParams to JAQL payload
  *

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

@@ -1,5 +1,5 @@
-import { BaseQueryParams } from '../../../domains/query-execution/index.js';
-import { NlqResponseJSON, NlqTranslationResult } from '../types.js';
+import { BaseQueryParams } from '../../../../domains/query-execution/index.js';
+import { NlqResponseJSON, NlqTranslationResult } from '../../types.js';
 /**
  * Translates CSDK BaseQueryParams to NLQ JSON format.
  * Direction: CSDK → JSON

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

@@ -0,0 +1,19 @@
+import type { Attribute, Measure } from '@sisense/sdk-data';
+import type { JSONArray } from '@sisense/sdk-data';
+import type { StyledColumn, StyledMeasureColumn } from '../../../../../domains/visualizations/core/chart-data-options/types.js';
+import type { NlqTranslationError } from '../../../types.js';
+import type { DimensionItemJSON, DimensionTranslationItem, MeasureItemJSON, MeasureTranslationItem } from '../../types.js';
+/**
+ * Shared adapters and utilities for data options translation.
+ * Used by chart and pivot-table translators.
+ *
+ * @internal
+ */
+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/data-options/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared data options translation utilities.
+ * Used by chart and pivot-table translators.
+ *
+ * @internal
+ */
+export { adaptDimensionsToStyledColumn, adaptMeasuresToStyledMeasureColumn, toJSONArray, withAxisContext, } from './adapters.js';
+export { translateSingleAxisFromJSON, type AxisType, type TranslatedAxis, } from './translate-axis-from-json.js';
+export { translateSingleAxisToJSON } from './translate-axis-to-json.js';