@sisense/sdk-ui 2.22.0 → 2.23.0

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';

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

@@ -0,0 +1,24 @@
+/**
+ * Translates a single data options axis from JSON to CSDK format.
+ * Shared by chart and pivot-table translators.
+ *
+ * @internal
+ */
+import type { Attribute, Measure } 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 { InternalDataSchemaContext } from '../../types.js';
+import { type AxisType } from './adapters.js';
+export type { AxisType };
+export type TranslatedAxis = (Attribute | StyledColumn)[] | (Measure | StyledMeasureColumn)[];
+/**
+ * Translates a single axis from JSON to CSDK format.
+ *
+ * @param axisKey - The axis key (e.g. 'category', 'value', 'rows', 'columns')
+ * @param axisValue - The axis value (array or single item)
+ * @param axisType - Whether the axis contains dimensions or measures
+ * @param context - Schema context for translation
+ * @param translationErrors - Array to collect errors into
+ * @returns Translated array or null if translation failed
+ */
+export declare function translateSingleAxisFromJSON(axisKey: string, axisValue: unknown, axisType: AxisType, context: InternalDataSchemaContext, translationErrors: NlqTranslationError[]): TranslatedAxis | null;

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

@@ -0,0 +1,18 @@
+/**
+ * Translates a single data options axis from CSDK to JSON format.
+ * Shared by chart and pivot-table translators.
+ *
+ * @internal
+ */
+import type { NlqTranslationResult } from '../../../types.js';
+import type { DimensionItemJSON, MeasureItemJSON } from '../../types.js';
+import type { AxisType } from './adapters.js';
+/**
+ * Translates a single axis from CSDK to JSON format.
+ *
+ * @param axisKey - The axis key (for error messages)
+ * @param axisValue - The axis value (array or single item)
+ * @param axisType - Whether the axis contains dimensions or measures
+ * @returns NlqTranslationResult with translated JSON array
+ */
+export declare function translateSingleAxisToJSON(axisKey: string, axisValue: unknown, axisType: AxisType): NlqTranslationResult<DimensionItemJSON[] | MeasureItemJSON[]>;

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

@@ -1,4 +1,4 @@
-import { FunctionContext, ProcessedArg } from '../../types.js';
+import { FunctionContext, ProcessedArg } from '../../../types.js';
 /**
  * Custom processor for measureFactory.customFormula that:
  * - Validates formula bracket references match context keys

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

@@ -1,3 +1,4 @@
+import type { SchemaIndex } from '../../utils/schema-index.js';
 export interface FormulaValidationResult {
     isValid: boolean;
     errors: string[];
@@ -14,7 +15,19 @@ export interface FormulaValidationOptions {
     allowEmptyFormula?: boolean;
     /** Custom error message prefix for better context */
     errorPrefix?: string;
+    /** When provided, time-diff args are validated as datetime dimensions and level-matched */
+    schemaIndex?: SchemaIndex;
 }
+export interface TimeDiffCall {
+    functionName: string;
+    ref1: string;
+    ref2: string;
+}
+/**
+ * Extracts time-diff (or other two-arg bracket) calls from a formula string.
+ * Matches FUNC([ref1], [ref2]) for each function name in the set (case-insensitive).
+ */
+export declare function parseTimeDiffCalls(formula: string, functionNames: readonly string[]): TimeDiffCall[];
 /**
  * Validates that all bracket references in a custom formula exist in the provided context
  * and provides helpful error messages for debugging.

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/execute-function.d.ts

@@ -1,4 +1,4 @@
-import { ProcessedArg, QueryElement } from '../types.js';
+import { ProcessedArg, QueryElement } from '../../types.js';
 /**
  * Executes a factory function with validated arguments using direct factory access
  */

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

@@ -2,7 +2,7 @@
  * Custom processing registry for factory functions that require complex validation
  * and transformation beyond basic argument type checking.
  */
-import { CustomFunctionProcessor } from '../types.js';
+import { CustomFunctionProcessor } from '../../types.js';
 /**
  * Registry mapping function paths to their custom processing functions.
  *

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/factory-function-schemas.d.ts

@@ -1,7 +1,7 @@
 /**
  * Comprehensive schema definitions for validating arguments to measureFactory and filterFactory functions.
  */
-import { ArgSchema } from '../types';
+import { ArgSchema } from '../../types.js';
 export declare const FACTORY_FUNCTION_SCHEMAS: Record<string, ArgSchema[]>;
 /**
  * Utility functions for working with function schemas

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

@@ -1,4 +1,4 @@
-import { FunctionContext, ProcessedArg } from '../types.js';
+import { FunctionContext, ProcessedArg } from '../../types.js';
 /**
  * Processes filters that accept string | number values
  * Used by: equals, doesntEqual

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

@@ -0,0 +1,25 @@
+/** Category of formula function for validation and translation. */
+export type FormulaFunctionCategory = 'time-diff' | 'aggregative' | 'math' | 'growth' | 'date';
+/** Metadata for a formula function (e.g. DDIFF, SUM). */
+export interface FormulaFunctionMeta {
+    category: FormulaFunctionCategory;
+    argCount: number;
+    /** Required date level for time-diff functions (e.g. DateLevels.Days for DDIFF). */
+    requiredDateLevel?: string;
+    /** Argument type constraint; 'datetime' means args must be datetime dimensions. */
+    argType?: 'datetime';
+}
+/** Registry keyed by formula function name (uppercase). */
+export declare const FORMULA_FUNCTION_SCHEMAS: Record<string, FormulaFunctionMeta>;
+/**
+ * Returns formula function names that are time-diff (SDIFF, MNDIFF, HDIFF, DDIFF, MDIFF, QDIFF, YDIFF).
+ */
+export declare function getTimeDiffFormulaFunctions(): readonly string[];
+/**
+ * Returns the required date level for a time-diff function, or undefined if not a time-diff function.
+ */
+export declare function getRequiredDateLevel(formulaFunctionName: string): string | undefined;
+/**
+ * Returns formula function names for a given category.
+ */
+export declare function getFormulaFunctionsByCategory(category: FormulaFunctionCategory): readonly string[];

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/process-arg.d.ts

@@ -1,4 +1,4 @@
-import { ArgInput, ProcessedArg } from '../types.js';
+import { ArgInput, ProcessedArg } from '../../types.js';
 /**
  * Processes a single argument based on its expected type schema
  *

package/dist/packages/sdk-ui/src/modules/analytics-composer/nlq-v3-translator/{process-function → shared/expression}/process-node.d.ts

@@ -1,4 +1,4 @@
-import { NodeInput, QueryElement } from '../types.js';
+import { NodeInput, QueryElement } from '../../types.js';
 /**
  * Recursively processes a parsed JSON object to execute filterFactory and measureFactory functions.
  * It includes comprehensive validation based on function schemas.