@sisense/sdk-ui 2.24.0 → 2.26.0

package/dist/packages/sdk-ui/src/domains/narrative/hooks/use-get-widget-narrative.d.ts

@@ -0,0 +1,62 @@
+import type { WidgetProps } from '../../../domains/widgets/components/widget/types';
+import type { WidgetNarrativeOptions } from '../core/widget-narrative-options.js';
+import { type WidgetNarrativeQueryState } from './use-widget-narrative-state.js';
+/**
+ * Options for {@link useGetWidgetNarrative}.
+ *
+ * @remarks
+ * Narration endpoints and flags default from `app.settings.narrative` on {@link useSisenseContext} when
+ * `isUnified` / `isSisenseAiEnabled` are omitted. Optional overrides match the
+ * imperative `getNlgInsightsFromWidget` helper for per-call behavior.
+ * @sisenseInternal
+ */
+export type UseGetWidgetNarrativeOptions = WidgetNarrativeOptions & {
+    /**
+     * When `false`, skips the narrative request.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+};
+/**
+ * @sisenseInternal
+ */
+export type UseGetWidgetNarrativeParams = {
+    /** Widget configuration whose query drives the narrative (chart or pivot). */
+    widgetProps: WidgetProps;
+} & UseGetWidgetNarrativeOptions;
+/**
+ * @sisenseInternal
+ */
+export type UseGetWidgetNarrativeResult = WidgetNarrativeQueryState & {
+    /**
+     * `true` when `widgetProps` is a chart or pivot widget and narrative params could be built
+     * (including resolving `dataSource` via `defaultDataSource`).
+     */
+    supported: boolean;
+    /**
+     * Mirrors {@link UseGetWidgetNarrativeOptions.enabled}. When `false`, narrative is opted out and
+     * `data` is not populated from cache.
+     */
+    enabled: boolean;
+};
+/**
+ * Fetches natural-language narrative for a widget {@link WidgetProps} using the same conversion
+ * path as {@link getNlgInsightsFromWidget}.
+ *
+ * Requires `useSisenseContext` with `app.httpClient` and a TanStack `QueryClientProvider` ancestor
+ * (typically provided by `SisenseContextProvider` in full apps).
+ *
+ * Text and custom widgets are unsupported: `supported` is false and no request runs.
+ *
+ * @example Headless usage
+ * ```tsx
+ * const { data, isLoading, supported } = useGetWidgetNarrative({
+ *   widgetProps,
+ *   defaultDataSource: DM.DataSource,
+ *   verbosity: 'Low',
+ * });
+ * ```
+ * @sisenseInternal
+ */
+export declare const useGetWidgetNarrative: (params: UseGetWidgetNarrativeParams) => UseGetWidgetNarrativeResult;

package/dist/packages/sdk-ui/src/domains/narrative/hooks/use-widget-narrative-state.d.ts

@@ -0,0 +1,39 @@
+import { WidgetProps } from '../../../domains/widgets/components/widget/types';
+import type { NarrativeRequest } from '../../../infra/api/narrative/narrative-api-types.js';
+import type { WidgetNarrativeOptions } from '../core/widget-narrative-options.js';
+/**
+ * Hook state aligned with legacy {@link UseGetNlgInsightsState}; used by {@link useGetWidgetNarrative}.
+ *
+ * @internal
+ */
+export type WidgetNarrativeQueryState = {
+    isLoading: boolean;
+    isError: boolean;
+    isSuccess: boolean;
+    data: string | undefined;
+    error: unknown;
+    refetch: () => void;
+};
+export type UseWidgetNarrativeStateParams = {
+    widgetProps: WidgetProps;
+    enabled?: boolean;
+} & WidgetNarrativeOptions;
+export type UseWidgetNarrativeStateResult = WidgetNarrativeQueryState & {
+    supported: boolean;
+    /**
+     * Mirrors the `enabled` param. When `false`, the narrative is opted out: `data` is cleared (no
+     * cached fallback), `narrativeRequest` is undefined, and loading/error flags reflect a disabled
+     * query rather than “no insights.”
+     */
+    enabled: boolean;
+    /** Present when `supported` and `enabled`; used by {@link WidgetNarrative} for feedback payload only. */
+    narrativeRequest: NarrativeRequest | undefined;
+};
+/**
+ * Resolves chart or pivot widget props to a narration request and runs `getNarrative` via TanStack Query.
+ * Depends on {@link useSisenseContext} (`httpClient`, narration settings) and a `QueryClientProvider`.
+ * Not exported from `@sisenseInternal` public API.
+ *
+ * @internal
+ */
+export declare function useWidgetNarrativeState({ widgetProps, defaultDataSource, verbosity, enabled, ignoreTrendAndForecast, isUnified: optionsUnified, isSisenseAiEnabled: optionsSisenseAi, }: UseWidgetNarrativeStateParams): UseWidgetNarrativeStateResult;

package/dist/packages/sdk-ui/src/domains/query-execution/core/date-formats/simple-date-format-replacers.d.ts

@@ -1,4 +1,17 @@
 import type { DateFormat } from './apply-date-format.js';
 export declare function newDateFormatWithUnicodeMillisecondsMasks(oldFormat: DateFormat): DateFormat;
 export declare function newDateFormatWithExpandedAMPM(oldFormat: DateFormat, date: Date, timeZone: string): DateFormat;
+/**
+ * Escapes Latin letter sequences that are not recognized Fusion date format tokens
+ * by wrapping them in single quotes so that `date-fns` treats them as literal text.
+ *
+ * Handles cases like `WEEK-ww` where `WEEK-` is a literal text prefix, but `W`, `E`,
+ * and `K` would otherwise be misinterpreted as `date-fns` format tokens, causing a
+ * RangeError.
+ *
+ * Adjacent non-token sequences (separated only by non-letter characters) are merged
+ * into a single quoted region to avoid `''` being interpreted as an escaped single
+ * quote by `date-fns`.
+ */
+export declare function newDateFormatWithEscapedNonTokenChars(format: DateFormat): DateFormat;
 export declare function newDateFormatWithExpandedTimezoneOffset(oldFormat: DateFormat, date: Date, timeZone: string, locale: Locale): DateFormat;

package/dist/packages/sdk-ui/src/domains/query-execution/hooks/use-execute-pivot-query/use-execute-pivot-query.d.ts

@@ -9,8 +9,8 @@ import { ExecutePivotQueryParams, PivotQueryState } from '../../types';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=queries%2Fuse-execute-pivot-query&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/query-execution/hooks/use-execute-query/use-execute-query.d.ts

@@ -10,8 +10,8 @@ import { ExecuteQueryParams, ExecuteQueryResult } from '../../types';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=queries%2Fuse-execute-query-sorting&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/area-chart.d.ts

@@ -10,8 +10,8 @@ import { AreaChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Farea-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/areamap-chart.d.ts

@@ -11,8 +11,8 @@ import { AreamapChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fmap-area&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/bar-chart.d.ts

@@ -10,8 +10,8 @@ import { BarChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fbar-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/boxplot-chart/boxplot-chart.d.ts

@@ -10,8 +10,8 @@ import { BoxplotChartProps } from '../../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fboxplot-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/chart.d.ts

@@ -9,8 +9,8 @@ import { ChartProps } from '../../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts/chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/chart/restructured-charts/highchart-based-charts/cartesians/helpers/highchart-options/axis.d.ts

@@ -1,5 +1,5 @@
 import { XAxisOrientation } from '../../../../../../../../../domains/visualizations/core/chart-options-processor/cartesian/utils/axis/axis-builders.js';
-import { AxisSettings } from '../../../../../../../../../domains/visualizations/core/chart-options-processor/translations/axis-section.js';
+import { type AxisSettings } from '../../../../../../../../../domains/visualizations/core/chart-options-processor/translations/axis-section.js';
 import { BuildContext } from '../../../types.js';
 import { CartesianChartTypes } from '../../types.js';
 export declare const getCartesianXAxis: (ctx: BuildContext<CartesianChartTypes>, orientation: XAxisOrientation) => AxisSettings[];

package/dist/packages/sdk-ui/src/domains/visualizations/components/column-chart.d.ts

@@ -12,8 +12,8 @@ import { ColumnChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fcolumn-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/funnel-chart.d.ts

@@ -9,8 +9,8 @@ import { FunnelChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Ffunnel-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/line-chart.d.ts

@@ -9,8 +9,8 @@ import { LineChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fline-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/pie-chart/pie-chart.d.ts

@@ -10,8 +10,8 @@ import { PieChartProps } from '../../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fpie-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/polar-chart.d.ts

@@ -9,8 +9,8 @@ import { PolarChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fpolar-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/scatter-chart.d.ts

@@ -15,8 +15,8 @@ import { ScatterChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fscatter-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/scattermap-chart.d.ts

@@ -9,8 +9,8 @@ import { ScattermapChartProps } from '../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fmap-scatter&mode=docs'
- *  width=1000
- *  height=900
+ *  width='1000'
+ *  height='900'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/sunburst-chart/sunburst-chart.d.ts

@@ -11,8 +11,8 @@ import { SunburstChartProps } from '../../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Fsunburst-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/table/table.d.ts

@@ -9,8 +9,8 @@ import { TableProps } from '../../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=tables%2Faggregated-table&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/components/treemap-chart/treemap-chart.d.ts

@@ -11,8 +11,8 @@ import { TreemapChartProps } from '../../../../props';
  *
  * <iframe
  *  src='https://csdk-playground.sisense.com/?example=charts%2Ftreemap-chart&mode=docs'
- *  width=800
- *  height=870
+ *  width='800'
+ *  height='870'
  *  style='border:none;'
  * />
  *

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-data-options/apply-styled-options-to-query.d.ts

@@ -0,0 +1,87 @@
+import { Attribute, CalculatedMeasureColumn, Column, Measure, MeasureColumn } from '@sisense/sdk-data';
+import type { CategoryStyle, SeriesStyle, StyledColumn, StyledMeasureColumn, ValueStyle } from './types.js';
+/**
+ * Name prefixes for trend and forecast measures in query payloads (aligned with NLQ JSON and chart).
+ *
+ * @internal
+ */
+export declare const TREND_PREFIX = "$trend";
+export declare const FORECAST_PREFIX = "$forecast";
+/**
+ * Dimension + optional category style for {@link adaptDimensionsForQuery}.
+ * Structurally matches NLQ `DimensionTranslationItem`.
+ *
+ * @internal
+ */
+export type DimensionQueryAdaptItem = {
+    attribute: Attribute;
+    style?: CategoryStyle;
+};
+/**
+ * Measure + optional value style for {@link adaptMeasuresForQuery}.
+ * Structurally matches NLQ `MeasureTranslationItem`.
+ *
+ * @internal
+ */
+export type MeasureQueryAdaptItem = {
+    measure: Measure;
+    style?: ValueStyle & SeriesStyle;
+};
+/**
+ * Dimensional {@link Attribute} instances expose JAQL sort APIs; plain {@link Column} does not.
+ *
+ * @internal
+ */
+export declare function isDimensionalAttribute(column: Column): column is Attribute;
+/**
+ * Narrative / NLQ query measures are dimensional {@link Measure} instances (e.g. from `measureFactory`).
+ *
+ * @internal
+ */
+export declare function isDimensionalMeasure(column: MeasureColumn | CalculatedMeasureColumn): column is Measure;
+/**
+ * Builds a dimension adapt item using `StyledColumn`’s own shape (no `splitColumn` merge).
+ *
+ * @internal
+ */
+export declare function toDimensionQueryAdaptItem(sc: StyledColumn): DimensionQueryAdaptItem;
+/**
+ * Builds a measure adapt item using `StyledMeasureColumn`’s own shape (no `splitColumn` merge).
+ *
+ * @internal
+ */
+export declare function toMeasureQueryAdaptItem(smc: StyledMeasureColumn): MeasureQueryAdaptItem;
+/**
+ * Applies sort from styled dimensions to attributes (NLQ JSON → query semantics).
+ *
+ * @internal
+ */
+export declare function adaptDimensionsForQuery(items: DimensionQueryAdaptItem[]): Attribute[];
+/**
+ * @internal
+ */
+export declare function isTrendMeasure(measure: Measure): boolean;
+/**
+ * @internal
+ */
+export declare function isForecastMeasure(measure: Measure): boolean;
+/**
+ * Options for {@link adaptMeasuresForQuery}.
+ *
+ * @internal
+ */
+export type AdaptMeasuresForQueryOptions = {
+    /**
+     * When `true`, trend and forecast companion measures are not appended (e.g. narrative when the
+     * backend does not yet support them).
+     *
+     * @default false
+     */
+    ignoreTrendAndForecast?: boolean;
+};
+/**
+ * Applies sort, trend, and forecast companion measures (NLQ JSON → query semantics).
+ *
+ * @internal
+ */
+export declare function adaptMeasuresForQuery(items: MeasureQueryAdaptItem[], options?: AdaptMeasuresForQueryOptions): Measure[];

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-data-options/translate-data-options.d.ts

@@ -1,8 +1,20 @@
 import { Attribute, Measure } from '@sisense/sdk-data';
 import { ChartType } from '../../../../types';
-import { CategoricalChartDataOptions, CategoricalChartDataOptionsInternal, ChartDataOptions, ChartDataOptionsInternal, PivotTableDataOptions, PivotTableDataOptionsInternal, TableDataOptions, TableDataOptionsInternal } from './types';
+import { CategoricalChartDataOptions, CategoricalChartDataOptionsInternal, ChartDataOptions, ChartDataOptionsInternal, PivotTableDataOptions, PivotTableDataOptionsInternal, StyledColumn, StyledMeasureColumn, TableDataOptions, TableDataOptionsInternal } from './types';
 export declare function translateChartDataOptions(chartType: ChartType, dataOptions: ChartDataOptions): ChartDataOptionsInternal;
 export declare const translateCategoricalChartDataOptions: (categorical: CategoricalChartDataOptions) => CategoricalChartDataOptionsInternal;
+/**
+ * Styled dimension columns used by charts for the same axes as {@link getAttributes}.
+ *
+ * @internal
+ */
+export declare function getStyledDimensionColumns(dataOptions: ChartDataOptionsInternal, chartType: ChartType): StyledColumn[];
+/**
+ * Styled measure columns used by charts for the same axes as {@link getMeasures}.
+ *
+ * @internal
+ */
+export declare function getStyledMeasureColumns(dataOptions: ChartDataOptionsInternal, chartType: ChartType): StyledMeasureColumn[];
 export declare function getAttributes(dataOptions: ChartDataOptionsInternal, chartType: ChartType): Attribute[];
 export declare function getMeasures(dataOptions: ChartDataOptionsInternal, chartType: ChartType): Measure[];
 export declare function translateTableDataOptions(dataOptions: TableDataOptions): TableDataOptionsInternal;

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-data-options/types.d.ts

@@ -652,12 +652,12 @@ export type IndicatorChartDataOptionsInternal = {
 /** @internal */
 export interface BoxplotChartDataOptionsInternal {
     category?: StyledColumn;
-    boxMin: StyledMeasureColumn;
-    boxMedian: StyledMeasureColumn;
-    boxMax: StyledMeasureColumn;
-    whiskerMin: StyledMeasureColumn;
-    whiskerMax: StyledMeasureColumn;
-    outliersCount: StyledMeasureColumn;
+    boxMin?: StyledMeasureColumn;
+    boxMedian?: StyledMeasureColumn;
+    boxMax?: StyledMeasureColumn;
+    whiskerMin?: StyledMeasureColumn;
+    whiskerMax?: StyledMeasureColumn;
+    outliersCount?: StyledMeasureColumn;
     outliers?: StyledColumn;
     valueTitle: string;
 }

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/cartesian/utils/axis/axis-builders.d.ts

@@ -62,6 +62,11 @@ export interface YAxisSettingsResult {
  * @returns true if continuous datetime X-axis should be used
  */
 export declare const isContinuousDatetimeXAxis: (xDataOptions: CartesianChartDataOptionsInternal['x']) => boolean;
+/**
+ * Returns true when every X-axis dimension is a datetime column.
+ * Used to decide whether multi-granularity date charts can still show the navigator.
+ */
+export declare const areAllDatetimeXAxes: (xDataOptions: CartesianChartDataOptionsInternal['x']) => boolean;
 /**
  * Builds Y-axis metadata from chart data and options
  *
@@ -87,7 +92,7 @@ export declare const getXAxisOrientation: (chartType: ChartType, yAxisChartTypes
  * @param isContinuous - Whether X-axis is continuous
  * @returns Categories metadata object
  */
-export declare const buildCategoriesMeta: (chartData: CartesianChartData, dataOptions: CartesianChartDataOptionsInternal, designOptions: ChartDesignOptions, isContinuous: boolean) => CategoriesMeta;
+export declare const buildCategoriesMeta: (chartData: CartesianChartData, dataOptions: CartesianChartDataOptionsInternal, designOptions: ChartDesignOptions, isContinuous: boolean, dateFormatter?: ((date: Date, format: string) => string) | undefined) => CategoriesMeta;
 /**
  * Builds X-axis settings based on whether it's continuous datetime or categorical
  *

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/plot-bands.d.ts

@@ -18,6 +18,7 @@ export declare const applyNumberFormatToPlotBands: (dataOptions: ChartDataOption
  * @param dataOptions -
  * @param designOptions -
  * @param continuousDatetimeXAxis -
+ * @param dateFormatter - When set, formats datetime x1/x2 labels from raw values (dual categorical axes)
  */
-export declare const getCategoriesIndexMapAndPlotBands: (data: ChartData, dataOptions: CartesianChartDataOptionsInternal, designOptions: DesignOptions, continuousDatetimeXAxis: boolean) => CategoryIndexMapPlotBands;
+export declare const getCategoriesIndexMapAndPlotBands: (data: ChartData, dataOptions: CartesianChartDataOptionsInternal, designOptions: DesignOptions, continuousDatetimeXAxis: boolean, dateFormatter?: ((date: Date, format: string) => string) | undefined) => CategoryIndexMapPlotBands;
 export {};

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/translations/axis-section.d.ts

@@ -23,6 +23,14 @@ export interface AxisLabelsFormatterContextObject {
         categories: (string | number)[];
     };
 }
+/**
+ * Subset of the Highcharts axis `afterSetExtremes` event payload used for navigator scroll persistence.
+ */
+export type NavigatorAxisSetExtremesEvent = {
+    min: number;
+    max: number;
+    trigger?: string;
+};
 export type AxisSettings = {
     type?: 'linear' | 'logarithmic';
     title?: {
@@ -74,6 +82,9 @@ export type AxisSettings = {
         description?: string;
         rangeDescription?: string;
     };
+    events?: {
+        afterSetExtremes?: (e: NavigatorAxisSetExtremesEvent) => void;
+    };
 };
 export type StackLabel = {
     style?: TextStyle;
@@ -118,4 +129,21 @@ export type AxisPlotBand = {
     };
 };
 export declare const getCategoricalCompareValue: (value: CategoricalXValues) => number;
-export declare const getDefaultDateFormat: (granularity?: string) => "yyyy" | "MM/yyyy" | "ww yyyy" | "HH:mm" | "HH:mm:ss" | "M/d/yy" | "yyyy Q" | "HH" | "M/d/yy HH" | undefined;
+/**
+ * Merges a navigator scroll callback into the primary X-axis `afterSetExtremes` handler.
+ * Preserves any existing `events` and prior `afterSetExtremes` implementation.
+ *
+ * @param axes - Axis settings (first entry is treated as the primary X-axis).
+ * @param onScrollerChange - Invoked only when extremes change due to the navigator scroller.
+ * @returns New axis settings array with the merged handler on the first axis.
+ */
+export declare const attachNavigatorScrollerToPrimaryXAxis: (axes: readonly AxisSettings[], onScrollerChange: (min: number, max: number) => void) => AxisSettings[];
+/**
+ * Transformer that merges a navigator scroll callback into the primary X-axis `afterSetExtremes` handler.
+ * No-ops when no callback is provided.
+ *
+ * @param onScrollerChange - Optional callback invoked when the navigator scroller changes extremes.
+ * @returns Transformer function over an axis settings array.
+ */
+export declare const withScrollerEvent: (onScrollerChange?: ((min: number, max: number) => void) | undefined) => (axes: readonly AxisSettings[]) => AxisSettings[];
+export declare const getDefaultDateFormat: (granularity?: string) => "yyyy" | "MM/yyyy" | "ww yyyy" | "HH:mm" | "HH:mm:ss" | "M/d/yy" | "HH" | "yyyy Q" | "M/d/yy HH" | undefined;

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/translations/design-options.d.ts

@@ -31,6 +31,7 @@ export type BaseDesignOptionsType = {
             min: number;
             max: number;
         };
+        onScrollerChange?: (min: number, max: number) => void;
     };
     dataLimits: DataLimits;
 };

package/dist/packages/sdk-ui/src/domains/visualizations/core/chart-options-processor/translations/tooltip-utils.d.ts

@@ -54,7 +54,7 @@ export type HighchartsDataPointContext = {
         custom?: {
             number1?: number;
             string1?: string;
-            xDisplayValue?: string;
+            xDisplayValue?: string | string[];
             xValue?: (number | string)[];
             monthDay?: number;
             hasData?: boolean;

package/dist/packages/sdk-ui/src/domains/visualizations/core/query-definition/compose-code-to-readable.d.ts

@@ -0,0 +1,32 @@
+import type { QueryPillItem } from './types';
+/**
+ * Structured tooltip model produced by {@link getQueryPillTooltipModel}.
+ *
+ * @sisenseInternal
+ */
+export type TooltipModel = {
+    layoutText: string;
+    typeLabel: 'Measure' | 'Dimension' | 'Filter';
+    /** Resolved field path or display fallback; may duplicate {@link TooltipModel.formula}. */
+    column: string;
+    formula: string;
+    /** When false, the UI omits the "Column:" row (empty/`-` or same as the pill display name). */
+    showColumnInTooltip: boolean;
+    /** When false, the UI omits the "Formula:" row (identical to Column, e.g. plain DM dimensions). */
+    showFormulaInTooltip: boolean;
+};
+/**
+ * Strips `measureFactory.`, `filterFactory.`, and `DM.` from compose code for tooltip display.
+ * Preserves the rest of the string (including quoted literals). Rare titles containing `DM.`
+ * inside quotes may be altered.
+ *
+ * @internal
+ */
+export declare function simplifyComposeCodeForTooltip(composeCode: string): string;
+/**
+ * Builds the structured tooltip model rendered by {@link QueryPill} from a {@link QueryPillItem}.
+ * Returns `null` when the item has no tooltip-eligible data (e.g. operator pills or pills without `tooltipData`).
+ *
+ * @sisenseInternal
+ */
+export declare function getQueryPillTooltipModel(item: QueryPillItem): TooltipModel | null;

package/dist/packages/sdk-ui/src/domains/visualizations/core/query-definition/index.d.ts

@@ -0,0 +1,9 @@
+export { QueryDefinition } from './query-definition';
+export type { QueryDefinitionProps } from './query-definition';
+export { QueryPill } from './query-pill';
+export type { QueryPillProps } from './query-pill';
+export { baseQueryParamsToViewModel } from './query-params-to-view-model';
+export { getQueryPillTooltipModel } from './compose-code-to-readable';
+export type { TooltipModel } from './compose-code-to-readable';
+export type { QueryPillCategory, QueryPillItem, ConnectorItem, QueryDefinitionViewModel, } from './types';
+export { isConnectorItem, isPillItem } from './types';

package/dist/packages/sdk-ui/src/domains/visualizations/core/query-definition/query-definition.d.ts

@@ -0,0 +1,26 @@
+import { type FunctionComponent } from 'react';
+import type { BaseQueryParams } from '../../../../domains/query-execution/types';
+import type { ChartProps } from '../../../../props';
+/**
+ * Props for the QueryDefinition component.
+ *
+ * @sisenseInternal
+ */
+export interface QueryDefinitionProps {
+    /** Either chart props (uses getTranslatedDataOptions internally) or base query params */
+    query: BaseQueryParams | ChartProps;
+    /** When true (default), pills show JSON tooltip on hover. */
+    showTooltip?: boolean;
+    /**
+     * Optional DOM box to clamp tooltips (e.g. chart card). Omit for viewport-only — the component
+     * root is only one row tall and must not be used as boundary (breaks vertical placement).
+     */
+    tooltipBoundaryElement?: HTMLElement | null;
+}
+/**
+ * Read-only query definition as colored pills above the widget.
+ * Order: Measures → Dimensions → Filters; collapsed to 4 pills with “Show N more” / “Show less”.
+ *
+ * @sisenseInternal
+ */
+export declare const QueryDefinition: FunctionComponent<QueryDefinitionProps>;